Microsoft Knowledge Base Email Alertz

This article demonstrates the use of the Web Distributed Authoring and Versioning (WebDAV) MKCOL command to create a new folder.

Search KbAlertz

Advanced Search

Receive Microsoft Knowledge Base articles by E-Mail?

Every night we scan the Microsoft Knowledge Base. If technologies you're interested in are updated, we'll send you an e-mail. You only get one e-mail a day, and only when new articles are added.

Click here to create a
FREE account
Already have an account?
[Click here to Login]











Microsoft Knowledge Base Article

This article contents is Microsoft Copyrighted material.
©2005-©2007 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks

Article ID: 289871 - Last Review: October 19, 2009 - Revision: 3.0

How To Use MKCOL in WebDAV to Create a New Folder

This article was previously published under Q289871

SUMMARY

This article demonstrates the use of the Web Distributed Authoring and Versioning (WebDAV) MKCOL command to create a new folder.

MORE INFORMATION

The following Visual C++ code sample uses the HTTPRequest object to send a MKCOL request to the Exchange server to create a new folder named "Testfolder" of type IPF.Appointment under Public Folders.

This sample requires Msxml.dll version 2.0 or later. To run this sample, follow these steps:
  1. In Visual C++, create a new Win32 console application and name it "Mysample".
  2. Replace the code in the Mysample.cpp file with the following code:
    include<stdio.h>
    
    //TODO: Change the path here if your Msxml.dll file is in a different location.
    
    #import "c:\winnt\system32\msxml.dll"
    
    //To  use MSXML 6.0 import the dll msxml4.dll instead of msxml.dll as follows 
    // #import "c:\winnt\system32\msxml6.dll"
    // using namespace MSXML2;
    
    using namespace MSXML;
    
    int main(int argc, char* argv[])
    {
       CoInitialize(NULL);
       try
       {
       //TODO: Change the line below to reflect your server.
       bstr_t yourServerName = "myserver1";
    
       bstr_t sUrl = "http:/" + yourServerName + "/public/Testfolder";
       bstr_t sMethod = "MKCOL";
             
       //TODO: Change the 2 lines below to reflect your user name and password.
       _variant_t vUser = L"myserver1\\User1";
       _variant_t vPassword = L"password";
             
       MSXML::IXMLHttpRequest* pXMLHttpReq=NULL;     
       HRESULT hr = ::CoCreateInstance(__uuidof(XMLHTTPRequest), 
                   NULL, 
                   CLSCTX_INPROC_SERVER, 
                   __uuidof(IXMLHttpRequest), 
                   (LPVOID*)&pXMLHttpReq);
    
       // To use MSXML 6.0 use the following Decleration and creation of pXMLHttpReq
       // IXMLHTTPRequestPtr pXMLHttpReq= NULL;
       // HRESULT hr=pXMLHttpReq.CreateInstance("Msxml2.XMLHTTP.6.0");
    
       if (S_OK != hr)
       {
           printf("XML Http Request pointer creation failed\n");
           return 0;
       }
    
       // Call open function.
       _variant_t vAsync = (bool)FALSE;
       pXMLHttpReq->open(sMethod, 
             sUrl, 
             vAsync, 
             vUser, 
             vPassword);
    
       pXMLHttpReq->setRequestHeader((bstr_t)"Content-Type",
          (bstr_t)"text/xml");
    
       bstr_t sReq;
       sReq =  "<?xml version='1.0'?>";
       sReq = sReq + 
          "<a:propertyupdate xmlns:a=" +
          "'DAV:' xmlns:ex='http://schemas.microsoft.com/exchange/'>";
       sReq = sReq + "<a:set><a:prop>";
       sReq = sReq + "<ex:outlookfolderclass>" +
          "IPF.Appointment" + //TODO: Change to the desired folder class
          "</ex:outlookfolderclass>";
       sReq = sReq + "</a:prop></a:set></a:propertyupdate>";
     
    
       // Send the request to set the search criteria.
       pXMLHttpReq->send(sReq);
    
       // OK, get response.     
       long lStatus;
       pXMLHttpReq->get_status(&lStatus);
    
       printf("\n~~~~~~~~\n%d\n", lStatus);
       BSTR bstrResp;
       pXMLHttpReq->get_statusText(&bstrResp);
       printf("\n~~~~~~~~\n%s\n", (char*)(bstr_t)bstrResp);
    
       _bstr_t bstrAllHeaders;
       bstrAllHeaders = pXMLHttpReq->getAllResponseHeaders();
       printf("\n~~~~~~~~\n%s\n", (char*)bstrAllHeaders);
    
       BSTR bstrResponseText;
       pXMLHttpReq->get_responseText(&bstrResponseText);
       printf("\n~~~~~~~~\n%s\n", (char*)(bstr_t)bstrResponseText);   
       }
       catch(_com_error &e)
       {
          printf("Error\a\a\n\tCode = %08lx\n"
             "\tCode meaning = %s\tSource = %s\n\tDescription = %s\n",
          e.Error(), 
          e.ErrorMessage(), 
          (char*)e.Source(), 
          (char*)e.Description() );
       }
    
       CoUninitialize(); 
       
       return 0;
    } 
    					
  3. Make the changes marked by "TODO:" in the code.
  4. Compile and then run the code.

    At the end, you will see the Status as "200 OK". The StatusText will display the status as "HTTP/1.1 201 Created" if the folder was created. You can then go to the Exchange System Manager and you will see the newly created Testfolder listed and it will be of type IPF.Appointment.


APPLIES TO
  • Microsoft Exchange 2000 Server Standard Edition
  • Microsoft XML Parser 2.0
  • Microsoft XML Parser 2.5
  • Microsoft XML Parser 2.6
  • Microsoft XML Parser 3.0
  • Microsoft XML Core Services 4.0
  • Microsoft Visual C++ 6.0 Enterprise Edition
  • Microsoft Visual C++ 6.0 Professional Edition
  • Microsoft Visual C++, 32-bit Learning Edition 6.0
  • Microsoft XML Core Services 6.0
Keywords: 
kbhowto kbmsg KB289871
       

Community Feedback System

Very often, it takes hours to solve a problem. Very often, you've looked high and low, and have tried a lot of solutions. When you finally found it, chances are, it was because someone else helped you. Here's your chance to give back. Use our community feedback tool to let others know what worked for you and what didn't.

Please also understand that the community feedback system is not warranted to be correct, it's simply a system that we've built to let people try and help each other. If something in a feedback response doesn't make sense to you, or you're not comfortable making changes that the feedback talks about (like registry edits), please consult a professional.

Thank you for using kbAlertz.com Feedback System.

-- Scott Cate