IProfAdmin Interface

IID_IProfAdmin

{00020325-0000-0000-C000-000000000046}

The IProfAdmin interface supports the administration of profiles.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IProfAdmin Methods

Description

GetLastError

Returns a MAPIERROR structure containing information about the previous error occurring to a profile administration object.

GetProfileTable

Provides access to the profile table a table with information about all of the available profiles.

CreateProfile

Creates a new profile.

DeleteProfile

Deletes a profile.

ChangeProfilePassword

Changes the password for a profile.

CopyProfile

Copies a profile.

RenameProfile

Assigns a new name to a profile.

SetDefaultProfile

Sets or clears a client's default profile.

AdminServices

Provides access to a message service administration object for making changes to the message services in a profile.

GetLastError

FUNCTION IProfAdmin_GetLastError ( _
  BYVAL pIProfAdmin AS DWORD PTR _
, BYVAL hResultCode AS LONG _
, BYVAL ulFlags AS DWORD _
, BYREF lppMAPIError AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIProfAdmin[3] USING IProfAdmin_GetLastError (pIProfAdmin, hResultCode, ulFlags, lppMAPIError) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetProfileTable

FUNCTION IProfAdmin_GetProfileTable ( _
  BYVAL pIProfAdmin AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
, BYREF lppTable AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIProfAdmin[4] USING IProfAdmin_GetProfileTable (pIProfAdmin, ulFlags, lppTable) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

CreateProfile

FUNCTION IProfAdmin_CreateProfile ( _
  BYVAL pIProfAdmin AS DWORD PTR _
, BYREF lpszProfileName AS ASCIIZ _
, BYREF lpszPassword AS ASCIIZ _
, BYVAL ulUIParam AS DWORD _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIProfAdmin[5] USING IProfAdmin_CreateProfile (pIProfAdmin, lpszProfileName, lpszPassword, ulUIParam, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

DeleteProfile

FUNCTION IProfAdmin_DeleteProfile ( _
  BYVAL pIProfAdmin AS DWORD PTR _
, BYREF lpszProfileName AS ASCIIZ _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIProfAdmin[6] USING IProfAdmin_DeleteProfile (pIProfAdmin, lpszProfileName, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

ChangeProfilePassword

FUNCTION IProfAdmin_ChangeProfilePassword ( _
  BYVAL pIProfAdmin AS DWORD PTR _
, BYREF lpszProfileName AS ASCIIZ _
, BYREF lpszOldPassword AS ASCIIZ _
, BYREF lpszNewPassword AS ASCIIZ _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIProfAdmin[7] USING IProfAdmin_ChangeProfilePassword (pIProfAdmin, lpszProfileName, lpszOldPassword, lpszNewPassword, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

CopyProfile

FUNCTION IProfAdmin_CopyProfile ( _
  BYVAL pIProfAdmin AS DWORD PTR _
, BYREF lpszProfileName AS ASCIIZ _
, BYREF lpszOldPassword AS ASCIIZ _
, BYREF lpszNewPassword AS ASCIIZ _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIProfAdmin[8] USING IProfAdmin_CopyProfile (pIProfAdmin, lpszProfileName, lpszOldPassword, lpszNewPassword, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

RenameProfile

FUNCTION IProfAdmin_RenameProfile ( _
  BYVAL pIProfAdmin AS DWORD PTR _
, BYREF lpszProfileName AS ASCIIZ _
, BYREF lpszOldPassword AS ASCIIZ _
, BYREF lpszNewPassword AS ASCIIZ _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIProfAdmin[9] USING IProfAdmin_RenameProfile (pIProfAdmin, lpszProfileName, lpszOldPassword, lpszNewPassword, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

SetDefaultProfile

FUNCTION IProfAdmin_SetDefaultProfile ( _
  BYVAL pIProfAdmin AS DWORD PTR _
, BYREF lpszProfileName AS ASCIIZ _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIProfAdmin[10] USING IProfAdmin_SetDefaultProfile (pIProfAdmin, lpszProfileName, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

AdminServices

FUNCTION IProfAdmin_AdminServices ( _
  BYVAL pIProfAdmin AS DWORD PTR _
, BYREF lpszProfileName AS ASCIIZ _
, BYREF lpszPassword AS ASCIIZ _
, BYVAL ulUIParam AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF lppServiceAdmin AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIProfAdmin[11] USING IProfAdmin_AdminServices (pIProfAdmin, lpszProfileName, lpszPassword, ulUIParam, ulFlags, lppServiceAdmin) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION