Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IProfAdmin::DeleteProfile

Published: July 16, 2012

Deletes a profile.

HRESULT DeleteProfile(
  LPSTR lpszProfileName,
  ULONG ulFlags
);
lpszProfileName

[in] A pointer to the name of the profile to be deleted.

ulFlags

[in] Always NULL.

S_OK

The profile was successfully deleted.

MAPI_E_NOT_FOUND

The specified profile does not exist.

The IProfAdmin::DeleteProfile method deletes a profile. If the profile to delete is in use when DeleteProfile is called, DeleteProfile returns S_OK but does not delete the profile immediately. Instead, DeleteProfile marks the profile for deletion and deletes it after it is no longer being used, when all of its active sessions have ended.

The entry point function for each message service in the profile is called with the MSG_SERVICE_DELETE value set in the ulContext parameter. First, the function deletes the service, and then it deletes the service's profile section. The message service entry point function is not called again after the service has been deleted.

No password is required to delete a profile.

For MFCMAPI sample code, see the following table.

File

Function

Comment

MAPIProfileFunctions.cpp

HrRemoveProfile

MFCMAPI uses the IProfAdmin::DeleteProfile method to delete the selected profile.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.