IX509EnrollmentPolicyServer::GetUseClientId-Methode (certenroll.h)
Die GetUseClientId-Methode ruft einen Wert ab, der angibt, ob das ClientId-Attribut in den Richtlinienserverflags des Zertifikatregistrierungsrichtlinienservers (Certificate Enrollment Policy, CEP) festgelegt ist.
Syntax
HRESULT GetUseClientId(
[out, retval] VARIANT_BOOL *pValue
);
Parameter
[out, retval] pValue
Zeiger auf einen booleschen Wert, der angibt, ob das PsfUseClientId-Bit für die PolicyServerUrlFlags-Enumeration für diesen CEP-Server (Certificate Enrollment Policy) festgelegt ist.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.
Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
| Rückgabecode | Beschreibung |
|---|---|
|
Der pValue-Parameter darf nicht NULL sein. |
Hinweise
Diese Methode gibt VARIANT_TRUE zurück, wenn das PsfUseClientId-Bit für die PolicyServerUrlFlags-Enumeration für diesen CEP-Server festgelegt ist. Wenn dieses Flag festgelegt ist, ist das ClientID-Attribut während des Registrierungsprozesses in Zertifikatanforderungen enthalten und kann von der Zertifizierungsstelle für Diagnose- oder Überwachungszwecke verwendet werden. Beispiele für den Informationstyp, der in diesem Attribut enthalten ist, sind der Name des Kryptografiedienstanbieters, die Windows-Versionsnummer, der Benutzername, der DNS-Name des Computers und der DNS-Name des Domänencontrollers.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | certenroll.h |