NPGetUniversalName 함수(npapi.h)

네트워크 리소스의 범용 이름을 검색합니다. NPGetUniversalName 함수는 UNC 형식 또는 이전의 원격 이름 형식으로 이 유니버설 이름을 검색할 수 있습니다.

구문

DWORD NPGetUniversalName(
  [in]      LPCWSTR lpLocalPath,
  [in]      DWORD   dwInfoLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

매개 변수

[in] lpLocalPath

네트워크 리소스에 있는 개체의 로컬 경로에 대한 포인터입니다. 드라이브 기반 경로입니다.

[in] dwInfoLevel

호출자가 관심 있는 정보의 세부 정보 수준입니다. 다음 값 중 하나일 수 있습니다.

값	의미
UNIVERSAL_NAME_INFO_LEVEL	이름의 UNC 형식(예: "file:\\server\share")을 검색합니다. 이 값을 설정하면 lpBuffer 에 반환된 데이터가 UNIVERSAL_NAME_INFO 구조체로 저장됩니다.
REMOTE_NAME_INFO_LEVEL	이름의 원격 형식(예: "\\server\share")을 검색합니다. 이 값을 설정하면 lpBuffer 에 반환된 데이터가 REMOTE_NAME_INFO 구조체로 저장됩니다.

[out] lpBuffer

사용자가 요청한 정보를 수신하는 버퍼에 대한 포인터입니다. 반환되는 특정 구조는 dwInfoLevel에 지정된 정보 수준에 따라 달라집니다.

[in, out] lpBufferSize

lpBuffer 버퍼의 크기(바이트)에 대한 포인터입니다. 버퍼가 충분히 크지 않아 호출이 실패하면 이 위치를 사용하여 필요한 버퍼 크기를 반환합니다.

반환 값

함수가 성공하면 WN_SUCCESS 반환해야 합니다. 그렇지 않으면 다음 중 하나일 수 있는 오류 코드를 반환해야 합니다.

반환 코드	설명
WN_BAD_LOCALNAME	lpLocalPath에 전달된 값이 잘못되었습니다.
WN_NOT_CONNECTED	lpLocalPath에 전달된 값은 리디렉션된 디바이스가 아닙니다.
WN_MORE_DATA	버퍼가 너무 작습니다.
WN_NO_NETWORK	네트워크가 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	npapi.h