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
This article demonstrates the use of the Web Distributed Authoring and Versioning (WebDAV) MKCOL command to create a new folder.
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:
- In Visual C++, create a new Win32 console application and name it "Mysample".
- 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;
}
- Make the changes marked by "TODO:" in the code.
- 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
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