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.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | 의미 |
|---|---|
|
지정된 인터페이스에 연결된 요청 다이얼 매개 변수가 없습니다. |
|
lpwsInterfaceName 매개 변수는 NULL입니다. |
|
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 |