Funzione di callback spQueryMetaDataFn (ntsecpkg.h)

Articolo
08/25/2023

Ottiene i metadati da un provider di supporto della sicurezza (SSP) quando avvia un contesto di sicurezza.

Sintassi

SpQueryMetaDataFn Spquerymetadatafn;

NTSTATUS Spquerymetadatafn(
  [in]           LSA_SEC_HANDLE CredentialHandle,
  [in, optional] PUNICODE_STRING TargetName,
  [in]           ULONG ContextRequirements,
  [out]          PULONG MetaDataLength,
  [out]          PUCHAR *MetaData,
  [in, out]      PLSA_SEC_HANDLE ContextHandle
)
{...}

Parametri

[in] CredentialHandle

Handle per le credenziali da usare per il contesto di sicurezza. Se il parametro ContextHandle punta a NULL in input, questa funzione usa il valore di questo parametro per creare un contesto di sicurezza.

Il valore di questo parametro non può essere NULL se il parametro ContextHandle punta a NULL in input.

[in, optional] TargetName

Puntatore a un UNICODE_STRING contenente il nome della destinazione del contesto.

[in] ContextRequirements

Flag che indicano gli attributi di contesto richiesti dal client.

I valori validi sono i seguenti. I valori possono essere combinati usando un'operazione OR logica.

Valore	Significato
ISC_REQ_DELEGATE	Il server è autorizzato a rappresentare il client.
ISC_REQ_MUTUAL_AUTH	Sia il client che il server devono dimostrare la propria identità.
ISC_REQ_REPLAY_DETECT	Il contesto di sicurezza supporta il rilevamento dei pacchetti riprodotti.
ISC_REQ_SEQUENCE_DETECT	Il contesto di sicurezza supporterà il rilevamento dei messaggi non ordinati.
ISC_REQ_USE_SESSION_KEY	È necessario negoziare una nuova chiave di sessione .
ISC_REQ_PROMPT_FOR_CREDS	Se il client è un utente interattivo, il pacchetto deve, se possibile, richiedere all'utente le credenziali appropriate.
ISC_REQ_USE_SUPPLIED_CREDS	Il buffer di input contiene informazioni sulle credenziali specifiche del pacchetto che devono essere usate per autenticare la connessione.
ISC_REQ_ALLOCATE_MEMORY	Il pacchetto deve allocare memoria. Il chiamante deve infine chiamare la funzione FreeContextBuffer per liberare memoria allocata dal pacchetto.
ISC_REQ_USE_DCE_STYLE	Il chiamante prevede una transazione di autenticazione reciproca a tre gambe.
ISC_REQ_DATAGRAM	Deve essere usato un canale di comunicazione di tipo datagram. Per altre informazioni, vedere Contesti di Datagram.
ISC_REQ_CONNECTION	Deve essere usato un canale di comunicazione di tipo connessione. Per altre informazioni, vedere Contesti orientati alla connessione.
ISC_REQ_EXTENDED_ERROR	Se il contesto ha esito negativo, generare un messaggio di risposta di errore per inviare nuovamente al client.
ISC_REQ_STREAM	Deve essere usato un canale di comunicazione di tipo di flusso. Per altre informazioni, vedere Contesti Stream.
ISC_REQ_INTEGRITY	L'integrità del buffer viene verificata; tuttavia, non verranno rilevati messaggi riprodotti e fuori sequenza.

[out] MetaDataLength

Dimensioni, in caratteri, del buffer MetaData .

[out] MetaData

Metadati forniti dal provider di servizi di configurazione.

[in, out] ContextHandle

Handle per l'handle di sicurezza da usare. Se questo parametro punta a NULL in input, questa funzione alloca e inizializza un contesto di sicurezza usando i valori dei parametri CredentialHandle e TargetName .

Se questo parametro punta a NULL nell'input, CredentialHandle non può essere NULL.

Valore restituito

Se la funzione ha esito positivo, restituire STATUS_SUCCESS o un codice di stato informativo.

Se la funzione ha esito negativo, restituisce un codice di errore NTSTATUS che indica il motivo per cui non è riuscito. Per altre informazioni, vedere la sezione Osservazioni.

Commenti

Un puntatore alla funzione SpQueryMetaDataFn è disponibile nella struttura SECPKG_FUNCTION_TABLE ricevuta dalla funzione SpLsaModeInitialize .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntsecpkg.h

Condividi tramite