MprConfigInterfaceGetHandle 함수(mprapi.h)

MprConfigInterfaceGetHandle 함수는 지정된 라우터 구성에서 지정된 인터페이스의 구성에 대한 핸들을 검색합니다.

구문

DWORD MprConfigInterfaceGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  LPWSTR lpwsInterfaceName,
  [out] HANDLE *phRouterInterface
);

[in] hMprConfig

라우터 구성에 대한 핸들입니다. MprConfigServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] lpwsInterfaceName

구성 핸들이 요청되는 인터페이스의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 인터페이스 GUID를 LAN 인터페이스의 이름으로 사용합니다.

[out] phRouterInterface

핸들 변수에 대한 포인터입니다. 이 변수는 인터페이스 구성에 대한 핸들을 받습니다.

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

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

값	의미
ERROR_INVALID_PARAMETER	hMprConfig 매개 변수가 NULL이거나 lpwsInterfaceName 매개 변수가 NULL이거나 두 매개 변수가 모두 NULL입니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 완료할 리소스가 부족합니다.
ERROR_NO_SUCH_INTERFACE	라우터 구성에서 지정된 인터페이스를 찾을 수 없습니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.