MprConfigGetFriendlyName 함수(mprapi.h)

MprConfigGetFriendlyName 함수는 지정된 GUID 이름에 해당하는 인터페이스의 이름을 반환합니다.

구문

DWORD MprConfigGetFriendlyName(
  [in]  HANDLE hMprConfig,
  [in]  PWSTR  pszGuidName,
  [out] PWCHAR pszBuffer,
  [in]  DWORD  dwBufferSize
);

[in] hMprConfig

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

[in] pszGuidName

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

[out] pszBuffer

인터페이스의 이름을 받는 버퍼에 대한 포인터입니다.

[in] dwBufferSize

pszBuffer가 가리키는 버퍼의 크기(바이트)를 지정합니다.

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

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

값	의미
ERROR_BUFFER_OVERFLOW	pszBuffer가 가리키는 버퍼가 반환된 GUID 이름을 보유할 만큼 크지 않습니다.
ERROR_INVALID_PARAMETER	다음 매개 변수 hMprConfig, pszGuidName 또는 pszBuffer 중 하나는 NULL입니다.
ERROR_NOT_FOUND	지정된 식별 이름에 해당하는 GUID 이름을 찾을 수 없습니다.

자세한 내용은 버퍼 오버런 방지를 참조하세요.