MprAdminInterfaceSetCredentialsEx 함수(mprapi.h)

아티클
02/29/2024

MprAdminInterfaceSetCredentialsEx 함수를 사용하여 인터페이스에 대한 확장 자격 증명 정보를 설정합니다. 이 함수를 사용하여 EAP(Extensible Authentication Protocols)에 사용되는 자격 증명 정보를 설정합니다.

구문

DWORD MprAdminInterfaceSetCredentialsEx(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

매개 변수

[in] hMprServer

라우터에 대한 핸들입니다. 이 핸들은 MprAdminServerConnect에 대한 이전 호출에서 가져옵니다.

[in] hInterface

인터페이스에 대한 핸들입니다. 이 핸들은 MprAdminInterfaceCreate에 대한 이전 호출에서 가져옵니다.

[in] dwLevel

lpbBuffer 매개 변수에서 정보가 구조화된 형식을 설명하는 DWORD 값입니다. 다음 표에 나열된 대로 dwLevel 에 허용되는 값에는 0 또는 1이 포함됩니다. 값 1은 정보가 인터페이스의 미리 공유된 키임을 나타냅니다.

값	구조체 형식
0	Windows 2000 Server: MPR_CREDENTIALSEX_0
1	Windows Server 2003 이상: MPR_CREDENTIALSEX_1

[in] lpbBuffer

MPR_CREDENTIALSEX_0 또는 MPR_CREDENTIALSEX_1 구조체에 대한 포인터입니다. dwLevel 매개 변수는 구조체의 형식을 나타냅니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

값	의미
ERROR_ACCESS_DENIED	호출 애플리케이션에 충분한 권한이 없습니다.
ERROR_INVALID_HANDLE	hInterface 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER	lplpbBuffer 매개 변수는 NULL입니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 완료할 리소스가 부족합니다.
ERROR_NOT_SUPPORTED	dwLevel 값이 잘못되었습니다.

설명

미리 공유된 키를 삭제하려면 MPR_CREDENTIALSEX_1 구조체의 dwSize 멤버를 0으로 설정하여 MprAdminInterfaceSetCredentials를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	mprapi.h
라이브러리	Mprapi.lib
DLL	Mprapi.dll