ICEnroll::enumContainers-Methode (xenroll.h)
[Diese Methode steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]
Die enumContainers-Methode ruft die Namen von Containern für den Kryptografiedienstanbieter (Cryptographic Service Provider , CSP) ab, der von der ProviderName-Eigenschaft angegeben wird. Diese Methode wurde zuerst in der ICEnroll-Schnittstelle definiert.
Syntax
HRESULT enumContainers(
[in] LONG dwIndex,
[out] BSTR *pbstr
);
Parameter
[in] dwIndex
Gibt die Ordnungsposition des Containers an, dessen Name abgerufen wird. Geben Sie null für den ersten Container an.
[out] pbstr
Ein Zeiger auf eine BSTR-Variable , die den Namen des Containers empfängt. Wenn Sie die Verwendung des BSTR abgeschlossen haben, geben Sie ihn frei, indem Sie die SysFreeString-Funktion aufrufen.
Rückgabewert
C++
Der Rückgabewert ist ein HRESULT. Ein Wert von S_OK gibt den Erfolg an. Der Wert ERROR_NO_MORE_ITEMS wird zurückgegeben, wenn keine weiteren Elemente vorhanden sind.VB
Der Rückgabewert ist eine String-Variable , die den Namen des Containers darstellt. Eine Ausnahme wird ausgelöst, wenn ein Fehler auftritt oder wenn keine weiteren Elemente vorhanden sind.Hinweise
Wenn der Wert der ProviderName-Eigenschaft nicht festgelegt wurde, wird der Standardwert (in der Regel Microsoft Base Cryptographic Provider) von ProviderName verwendet, der in der Registrierung festgelegt ist.
Diese Methode ist deaktiviert, wenn das Zertifikatregistrierungssteuerelement als skriptbasiertes Steuerelement ausgeführt wird.
Beispiele
BSTR bstrCon = NULL;
DWORD nCon = 0;
HRESULT hr;
// pEnroll is previously instantiated ICEnroll interface pointer
while ( S_OK == pEnroll->enumContainers(nCon, &bstrCon) )
{
printf("\t%d) %ws\n", nCon++, bstrCon );
if ( bstrCon )
{
SysFreeString( bstrCon );
bstrCon = NULL;
}
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | xenroll.h |
| Bibliothek | Uuid.lib |
| DLL | Xenroll.dll |