NPGetResourceParent 함수(npapi.h)

찾아보기 계층 구조에서 지정된 네트워크 리소스의 부모를 검색합니다. 이 함수는 일반적으로 NPEnumResource 또는 NPGetResourceInformation에 대한 이전 호출에서 동일한 공급자가 반환한 리소스에 대해 호출됩니다.

구문

DWORD NPGetResourceParent(
  [in]      LPNETRESOURCEW lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpBufferSize
);

매개 변수

[in] lpNetResource

부모 이름이 필요한 네트워크 리소스에 대한 포인터입니다. NETRESOURCE는 NPEnumResource 또는 NPGetResourceInformation에 대한 이전 호출에서 가져오거나 호출자에 의해 생성되었을 수 있습니다.

lpRemoteName 필드는 부모가 필요한 네트워크 리소스의 원격 이름을 지정합니다.

lpProvider 필드는 호출할 공급자를 지정합니다. 이 항목은 제공해야 합니다.

호출 프로그램이 해당 값을 알고 있는 경우 dwType 필드가 채워집니다. 그렇지 않으면 NULL로 설정됩니다.

NETRESOURCE의 다른 모든 필드는 무시되며 초기화되지 않습니다.

[out] lpBuffer

결과를 수신할 버퍼에 대한 포인터로, 부모 리소스를 나타내는 단일 NETRESOURCE 구조체입니다. lpRemoteName, lpProvider, dwType, dwDisplayType 및 dwUsage 필드가 반환됩니다. 다른 모든 필드는 NULL로 설정됩니다.

출력 lpRemoteName 은 NPEnumResource에서 열거형에서 반환된 형식과 동일한 형식이어야 하므로 호출자는 대/소문자 구분 문자열 비교를 수행하여 부모 리소스가 NPEnumResource에서 반환한 리소스와 동일한지 여부를 확인할 수 있습니다. 입력 리소스에 구문적으로 부모가 있는 경우 공급자는 입력 리소스 또는 해당 부모가 실제로 존재하는지 여부를 결정하지 않고 반환할 수 있습니다. 리소스에 네트워크에서 찾아보기 부모가 없는 경우 lpRemoteName 이 NULL로 반환됩니다.

반환된 dwUsage 필드의 RESOURCEUSAGE_CONNECTABLE 비트는 리소스가 현재 연결될 수 있음을 반드시 나타내는 것은 아니며, 네트워크에서 리소스를 사용할 수 있을 때만 연결할 수 있음을 나타냅니다.

[in, out] lpBufferSize

lpBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정하는 위치에 대한 포인터입니다. 버퍼가 결과에 비해 너무 작으면 함수는 필요한 버퍼 크기를 이 위치에 배치하고 오류 WN_MORE_DATA 반환합니다.

반환 값

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

반환 코드	설명
WN_MORE_DATA	입력 버퍼가 너무 작습니다.
WN_BAD_NETNAME	이 공급자는 lpNetResource 로 지정된 리소스를 소유하지 않습니다(또는 리소스가 구문적으로 유효하지 않음).
WN_BAD_VALUE	dwUsage 또는 dwType이 잘못되었거나 지정된 매개 변수의 잘못된 조합이 있습니다(예: lpRemoteName은 dwType에 대해 구문적으로 유효하지 않음).
WN_NOT_AUTHENTICATED	호출자가 네트워크에 인증되지 않았습니다.
WN_ACCESS_DENIED	호출자가 네트워크에 인증되었지만 충분한 권한이 없습니다.

요구 사항

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