ICertAdmin2::GetMyRoles-Methode (certadm.h)

Artikel
08/22/2023

Die GetMyRoles-Methode ruft die Zertifizierungsstellenrollen des Aufrufers ab.

Syntax

HRESULT GetMyRoles(
  [in]  const BSTR strConfig,
  [out] LONG       *pRoles
);

Parameter

[in] strConfig

Zeichenfolgenwert, der eine gültige Konfigurationszeichenfolge für die Zertifizierungsstelle im Format COMPUTERNAME\CANAME darstellt, wobei COMPUTERNAME der Netzwerkname des Zertifikatdiensteservers und CANAME der allgemeine Name der Zertifizierungsstelle ist, wie er während der Einrichtung der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

WichtigGetMyRoles löscht den internen Cache nicht, wenn die Konfigurationszeichenfolge geändert wird. Wenn Sie die Konfigurationszeichenfolge für die Zertifizierungsstelle ändern, müssen Sie ein neues ICertAdmin-Objekt instanziieren und diese Methode erneut mit der neuen Konfigurationszeichenfolge aufrufen.

[out] pRoles

Ein Zeiger auf einen LONG-Wert , der die abgerufenen Zertifizierungsstellenrollen für den Aufrufer darstellt. Dies kann eine bitweise Kombination aus null oder mehr der folgenden Werte sein.

Wert	Bedeutung
CA_ACCESS_ADMIN 0x1	Der Aufrufer verfügt über eine Zertifizierungsstellenadministratorfunktion.
CA_ACCESS_AUDITOR 0x4	Der Aufrufer verfügt über die Zertifizierungsstellenprüferfunktion.
CA_ACCESS_ENROLL 0x200	Der Aufrufer verfügt über Registrierungszugriff.
CA_ACCESS_OFFICER 0x2	Der Anrufer verfügt über eine Ca-Officer-Funktion.
CA_ACCESS_OPERATOR 0x8	Der Aufrufer verfügt über eine Ca-Sicherungsfunktion.
CA_ACCESS_READ 0x100	Der Aufrufer verfügt über Lesezugriff der Zertifizierungsstelle.

Rückgabewert

C++

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein HRESULT, das den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Der Rückgabewert ist ein Long-Wert , der die abgerufenen ZS-Rollen für den Aufrufer darstellt. Dies kann eine bitweise Kombination aus null oder mehr der folgenden Werte sein.

Rückgabecode/-wert	BESCHREIBUNG
CA_ACCESS_ADMIN 0x1	Der Aufrufer verfügt über eine Zertifizierungsstellenadministratorfunktion.
CA_ACCESS_AUDITOR 0x4	Der Aufrufer verfügt über die Zertifizierungsstellenprüferfunktion.
CA_ACCESS_ENROLL 0x200	Der Aufrufer verfügt über Registrierungszugriff.
CA_ACCESS_OFFICER 0x2	Der Anrufer verfügt über eine Ca-Officer-Funktion.
CA_ACCESS_OPERATOR 0x8	Der Aufrufer verfügt über eine Ca-Sicherungsfunktion.
CA_ACCESS_READ 0x100	Der Aufrufer verfügt über Lesezugriff.

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certadm.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certadm.dll

Weitere Informationen

ICertAdmin2

Freigeben über