Funzione MprAdminServerGetCredentials (mprapi.h)

La funzione MprAdminServerGetCredentials recupera la chiave precondivisa per il server specificato.

Sintassi

DWORD MprAdminServerGetCredentials(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Parametri

[in] hMprServer

Gestire in un server Windows. Ottenere questo handle chiamando MprAdminMIBServerConnect.

[in] dwLevel

Valore DWORD che descrive il formato in cui vengono restituite le informazioni nel parametro lplpbBuffer . Deve essere zero.

[out] lplpbBuffer

Al termine, un puntatore a una struttura MPR_CREDENTIALSEX_1 che contiene la chiave precondi shared per il server. Liberare la memoria occupata da questa struttura con MprAdminBufferFree.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene 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_PARAMETER	Il parametro lplpbBuffer è NULL.
ERROR_NOT_SUPPORTED	Il parametro dwLevel non è zero.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Commenti

Il server gestisce una singola chiave precondi shared per tutti gli utenti.

Requisiti

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

Vedi anche

MPR_CREDENTIALSEX_1

MprAdminServerSetCredentials

Funzioni di amministrazione router

Informazioni di riferimento sulla gestione dei router