Funzione EnumerateSecurityPackagesW (sspi.h)

Articolo
11/20/2024

La funzione EnumerateSecurityPackages restituisce una matrice di strutture SecPkgInfo secpkgInfo che forniscono informazioni sui pacchetti di sicurezza disponibili per il client.

Sintassi

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY EnumerateSecurityPackagesW(
  [in] unsigned long *pcPackages,
  [in] PSecPkgInfoW  *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 del provider di supporto della sicurezza (SSP) che descrive le funzionalità del pacchetto di sicurezza disponibile in 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 solo, quelli 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	Impossibile trovare il pacchetto specificato.

Osservazioni

Il chiamante può usare il nome membro di una struttura SecPkgInfo per specificare un pacchetto di sicurezza in una chiamata alla funzione AcquireCredentialsHandle (Generale).

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	sspi.h (include Security.h)
libreria	Secur32.lib
dll	SspiCli.dll

Vedere anche

acquireCredentialsHandle (Generale)

FreeContextBuffer

funzioni SSPI

secPkgInfo

Condividi tramite