MprAdminInterfaceSetCredentials 함수(mprapi.h)

아티클
08/24/2023

MprAdminInterfaceSetCredentials 함수를 사용하여 지정된 수요 다이얼 인터페이스에서 전화를 거는 데 사용할 도메인, 사용자 이름 및 암호를 설정합니다.

구문

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

매개 변수

[in] lpwsServer

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

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

[in] lpwsInterfaceName

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

[in] lpwsUserName

사용자 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 이 인터페이스와 연결된 사용자 이름을 변경하지 않습니다.

[in] lpwsDomainName

도메인 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

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

[in] lpwsPassword

암호를 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 이 인터페이스와 연결된 암호를 변경하지 않습니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	다음 중 적어도 하나가 참입니다. lpwsInterfaceName 매개 변수가 NULL이거나 MAX_INTERFACE_NAME_LEN 이상입니다. lpwsUserName, lpwsPassword 및 lpwsDomainName 매개 변수 중 하나 이상이 너무 길어서 유효하지 않습니다. 자세한 내용은 설명 부분을 참조하세요.
ERROR_NOT_ENOUGH_MEMORY	자격 증명을 포함할 새 데이터 구조를 만들기 위한 메모리가 부족합니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

lpwsUserName, lpwsPassword 및 lpwsDomainName 매개 변수는 선택 사항입니다. 호출 애플리케이션이 세 매개 변수 모두에 대해 NULL 을 지정하는 경우 MprAdminInterfaceSetCredentials 는 이 인터페이스에 대한 모든 자격 증명 정보를 제거합니다.

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

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

요구 사항


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