Funzione EnumerateSecurityPackagesA (sspi.h)
La funzione EnumerateSecurityPackages restituisce una matrice di strutture SecPkgInfo che forniscono informazioni sui pacchetti di sicurezza disponibili per il client.
Sintassi
SECURITY_STATUS SEC_ENTRY EnumerateSecurityPackagesA(
[in] unsigned long *pcPackages,
[in] PSecPkgInfoA *ppPackageInfo
);
Parametri
[in] pcPackages
Puntatore a una variabile ULONG che riceve il numero di pacchetti disponibili nel sistema. Sono inclusi i pacchetti già caricati e i pacchetti disponibili su richiesta.
[in] ppPackageInfo
Puntatore a una variabile che riceve un puntatore a una matrice di strutture SecPkgInfo . Ogni struttura contiene informazioni provenienti dal provider di supporto per la sicurezza (SSP) che descrive le funzionalità del pacchetto di sicurezza disponibile all'interno di tale provider di servizi condivisi.
Al termine dell'uso della matrice, liberare la memoria chiamando la funzione FreeContextBuffer .
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce SEC_E_OK.
Se la funzione ha esito negativo, restituisce un codice di errore diverso da zero. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice/valore restituito | Descrizione |
|---|---|
|
Memoria insufficiente per allocare uno o più buffer. |
|
È stato specificato un handle non valido. |
|
Il pacchetto specificato non è stato trovato. |
Commenti
Il chiamante può usare il membro Name di una struttura SecPkgInfo per specificare un pacchetto di sicurezza in una chiamata alla funzione AcquireCredentialsHandle (General).
Nota
L'intestazione sspi.h definisce EnumerateSecurityPackages come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 | sspi.h (include Security.h) |
| Libreria | Secur32.lib |
| DLL | SspiCli.dll |