MprAdminServerConnect 함수(mprapi.h)

MprAdminServerConnect 함수는 해당 라우터를 관리하기 위해 라우터에 대한 연결을 설정합니다. 서버에 대한 다른 호출을 하기 전에 이 함수를 호출합니다. 후속 호출에서 반환된 핸들을 사용하여 서버의 인터페이스를 관리합니다.

구문

DWORD MprAdminServerConnect(
  [in, optional] LPWSTR            lpwsServerName,
  [out]          MPR_SERVER_HANDLE *phMprServer
);

[in, optional] lpwsServerName

원격 서버의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 함수는 로컬 컴퓨터에 대한 핸들을 반환합니다.

[out] phMprServer

서버에 대한 핸들을 수신하는 HANDLE 변수에 대한 포인터입니다. 후속 호출에서 이 핸들을 사용하여 서버를 관리합니다.

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

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

값	의미
ERROR_ACCESS_DENIED	호출 애플리케이션에 충분한 권한이 없습니다.
RPC_S_INVALID_BINDING	이 함수는 phMprServer 매개 변수가 NULL과 같음으로 호출되었습니다.
RPC_S_UNKNOWN_IF	지정된 컴퓨터가 라우팅 및 RAS 서비스를 실행하고 있지 않습니다.

MprAdminIsServiceRunning을 사용하여 원격 서버에서 RRAS 서비스의 상태 확인해야 합니다. MprAdminServerConnect 는 연결을 설정할 때 RRAS 서비스를 쿼리하지 않습니다.