IAzScope::CreateRole-Methode (azroles.h)

Die CreateRole-Methode erstellt ein IAzRole-Objekt mit dem angegebenen Namen.

Syntax

HRESULT CreateRole(
  [in]           BSTR    bstrRoleName,
  [in, optional] VARIANT varReserved,
  [out]          IAzRole **ppRole
);

[in] bstrRoleName

Name für das neue IAzRole-Objekt .

[in, optional] varReserved

Für die zukünftige Verwendung reserviert.

[out] ppRole

Ein Zeiger auf einen Zeiger auf das erstellte IAzRole-Objekt .

Der Rückgabewert ist ein HRESULT. Ein Wert von S_OK gibt den Erfolg an. Jeder andere Wert gibt an, dass beim Vorgang ein Fehler aufgetreten ist.

Sie müssen die IAzRole::Submit-Methode aufrufen, um alle Am zurückgegebenen Objekt vorgenommenen Änderungen beizubehalten.

Das zurückgegebene IAzRole-Objekt ist ein unmittelbar untergeordnetes Objekt des IAzScope-Objekts .

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	azroles.h
Bibliothek	Azroles.lib
DLL	Azroles.dll
Verteilbare Komponente	Windows Server 2003 Administration Tools Pack unter Windows XP