Share via

MprAdminInterfaceGetHandle 함수(mprapi.h)

  • 아티클

MprAdminInterfaceGetHandle 함수는 지정된 인터페이스에 대한 핸들을 검색합니다.

구문

DWORD MprAdminInterfaceGetHandle(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  LPWSTR            lpwsInterfaceName,
  [out] HANDLE            *phInterface,
  [in]  BOOL              fIncludeClientInterfaces
);

매개 변수

[in] hMprServer

이 호출을 실행할 라우터에 대한 핸들입니다. MprAdminServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] lpwsInterfaceName

검색할 인터페이스의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[out] phInterface

lpwsInterfaceName에 지정된 인터페이스에 대한 핸들을 수신하는 HANDLE 변수에 대한 포인터입니다.

[in] fIncludeClientInterfaces

함수가 클라이언트 인터페이스를 반환할지 여부를 지정합니다. 이 매개 변수가 FALSE이면 lpwsInterfaceName으로 지정된 이름의 인터페이스 검색에서 ROUTER_IF_TYPE_CLIENT 형식의 인터페이스가 무시됩니다. 이 매개 변수가 TRUE 이고 지정된 이름의 인터페이스가 있는 경우 MprAdminInterfaceGetHandle 은 ROUTER_IF_TYPE_CLIENT 형식의 인터페이스에 대한 핸들을 반환합니다. ROUTER_IF_TYPE_CLIENT 형식의 여러 인터페이스가 있을 수 있으므로 반환된 핸들은 lpwsInterfaceName으로 지정된 이름으로 찾은 첫 번째 인터페이스를 참조합니다.

반환 값

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

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

값 의미
ERROR_ACCESS_DENIED
 호출 애플리케이션에 충분한 권한이 없습니다.
ERROR_NO_SUCH_INTERFACE
 lpwsInterfaceName으로 지정된 이름의 인터페이스가 없습니다.
RPC_S_INVALID_BINDING
 서버에 전달된 핸들이 NULL입니다.
RPC_X_NULL_REF_POINTER
 lpwsInterfaceName 은 NULL입니다.
 
 

요구 사항

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

참고 항목

MprAdminServerConnect

ROUTER_INTERFACE_TYPE

라우터 관리 함수

라우터 관리 참조