Funzione MprAdminInterfaceGetCredentialsEx (mprapi.h)

Articolo
03/05/2024

Usare la funzione MprAdminInterfaceGetCredentialsEx per recuperare le informazioni sulle credenziali estese per l'interfaccia specificata. Usare questa funzione per recuperare le informazioni sulle credenziali usate per i protocolli di autenticazione estendibili (EAPs).

Sintassi

DWORD MprAdminInterfaceGetCredentialsEx(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Parametri

[in] hMprServer

Gestire un router. Questo handle viene ottenuto da una chiamata precedente a MprAdminServerConnect.

[in] hInterface

Gestire l'interfaccia. Questo handle viene ottenuto da una chiamata precedente a MprAdminInterfaceCreate.

[in] dwLevel

Valore DWORD che descrive il formato in cui vengono restituite le informazioni nel parametro lplpbBuffer . I valori accettabili per dwLevel includono 0 o 1, come indicato nella tabella seguente.

Valore	Formato struttura
0	Windows 2000 Server: MPR_CREDENTIALSEX_0
1	Windows Server 2003 o versione successiva: MPR_CREDENTIALSEX_1

Un valore 1 indica che le informazioni sono una chiave pre-condivisa per l'interfaccia, che è in un formato crittografato.

[out] lplpbBuffer

Al termine, un puntatore a una struttura MPR_CREDENTIALSEX_0 o MPR_CREDENTIALSEX_1 . Il parametro dwLevel indica il tipo di struttura. Liberare la memoria occupata da questa struttura con MprAdminBufferFree.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_INVALID_HANDLE	Il valore hInterface non è valido.
ERROR_INVALID_PARAMETER	Il parametro lplpbBuffer è NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_NOT_SUPPORTED	Il valore dwLevel non è valido.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll