Funzione EnumerateSecurityPackagesA (sspi.h)

  • Articolo

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
SEC_E_INSUFFICIENT_MEMORY
0x80090300L
 Memoria insufficiente per allocare uno o più buffer.
SEC_E_INVALID_HANDLE
0x80090301L
 È stato specificato un handle non valido.
SEC_E_SECPKG_NOT_FOUND
0x80090305L
 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

Vedi anche

AcquireCredentialsHandle (Generale)

FreeContextBuffer

Funzioni SSPI

SecPkgInfo