MprAdminInterfaceGetCredentials 함수(mprapi.h)

MprAdminInterfaceGetCredentials 함수를 사용하여 지정된 요청 다이얼 인터페이스에서 전화를 걸기 위한 도메인, 사용자 이름 및 암호를 검색합니다.

구문

DWORD MprAdminInterfaceGetCredentials(
  [in]  LPWSTR lpwsServer,
  [in]  LPWSTR lpwsInterfaceName,
  [out] LPWSTR lpwsUserName,
  [out] LPWSTR lpwsPassword,
  [out] LPWSTR lpwsDomainName
);

매개 변수

[in] lpwsServer

이 호출을 실행할 라우터의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하면 로컬 컴퓨터에서 호출이 실행됩니다.

[in] lpwsInterfaceName

demand-dial 인터페이스의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. MprAdminInterfaceGetInfo를 사용하여 인터페이스 이름을 가져옵니다.

[out] lpwsUserName

사용자 이름을 받는 유니코드 문자열에 대한 포인터입니다. 이 문자열은 UNLEN+1 길이여야 합니다.

이 매개 변수는 선택 사항입니다. 호출하는 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 사용자 이름을 반환하지 않습니다.

[out] lpwsPassword

암호를 받는 유니코드 문자열에 대한 포인터입니다. 이 문자열은 PWLEN+1 길이여야 합니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 암호를 반환하지 않습니다.

[out] lpwsDomainName

도메인 이름을 수신하는 유니코드 문자열에 대한 포인터입니다. 이 문자열은 DNLEN+1 길이여야 합니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 도메인 이름을 반환하지 않습니다.

반환 값

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

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

값	의미
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	지정된 인터페이스에 연결된 요청 다이얼 매개 변수가 없습니다.
ERROR_INVALID_PARAMETER	lpwsInterfaceName 매개 변수는 NULL입니다.
NO_ERROR	lpwsUserName, lpwsPassword 및 lpwsDomainName 매개 변수는 모두 NULL입니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

lpwsUserName, lpwsPassword 및 lpwsDomainName 매개 변수는 선택 사항입니다. 호출 애플리케이션이 세 매개 변수 모두에 대해 NULL 을 지정하는 경우 MprAdminInterfaceGetCredentials 는 NO_ERROR 반환하며 도메인, 사용자 이름 및 암호는 반환되지 않습니다.

UNLEN, PWLEN 및 DNLEN 상수는 사용자 이름, 암호 및 도메인 이름의 최대 길이입니다. 이러한 상수는 lmcons.h에 정의됩니다.

MprAdminInterfaceGetCredentials의 매개 변수 순서는 MprAdminInterfaceSetCredentials와 다릅니다.

요구 사항

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

참고 항목

FormatMessage

MprAdminInterfaceSetCredentials

라우터 관리 함수

라우터 관리 참조