Metodo ICEnroll::enumContainers (xenroll.h)
[Questo metodo non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]
Il metodo enumContainers recupera i nomi dei contenitori per il provider di servizi di crittografia (CSP) specificato dalla proprietà ProviderName . Questo metodo è stato definito per la prima volta nell'interfaccia ICEnroll .
Sintassi
HRESULT enumContainers(
[in] LONG dwIndex,
[out] BSTR *pbstr
);
Parametri
[in] dwIndex
Specifica la posizione ordinale del contenitore il cui nome verrà recuperato. Specificare zero per il primo contenitore.
[out] pbstr
Puntatore a una variabile BSTR che riceve il nome del contenitore. Al termine dell'uso di BSTR, liberarlo chiamando la funzione SysFreeString .
Valore restituito
C++
Il valore restituito è HRESULT. Il valore S_OK indica l'esito positivo. Il valore ERROR_NO_MORE_ITEMS viene restituito quando non sono presenti altri elementi.VB
Il valore restituito è una variabile String che rappresenta il nome del contenitore. Viene generata un'eccezione se viene rilevato un errore o quando non sono presenti altri elementi.Commenti
Se il valore della proprietà ProviderName non è stato impostato, viene utilizzato il valore predefinito (in genere Provider di crittografia di base Microsoft) di ProviderName impostato nel Registro di sistema.
Questo metodo viene disabilitato quando il controllo di registrazione certificati viene eseguito come controllo con script.
Esempio
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;
}
}
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | xenroll.h |
| Libreria | Uuid.lib |
| DLL | Xenroll.dll |