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
);

Parameter

[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 .

Rückgabewert

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.

Hinweise

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 .

Anforderungen

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