NPSearchDialog 함수(npapi.h)

  • 아티클

네트워크 공급업체가 연결 대화 상자에 표시되는 계층적 보기를 넘어 고유한 형태의 검색 및 검색을 제공할 수 있습니다. 네트워크 공급자가 이 함수를 지원하는 경우 선택한 항목이 해당 공급자에 속할 때 연결 대화 상자에서 검색 단추를 사용하도록 설정합니다. 사용자가 검색 단추를 누르면 연결 대화 상자에서 NPSearchDialog 를 호출하여 사용자 요청을 처리합니다.

구문

DWORD NPSearchDialog(
  [in]  HWND           hwndParent,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPVOID         lpBuffer,
  [out] DWORD          cbBuffer,
  [in]  LPDWORD        lpnFlags
);

매개 변수

[in] hwndParent

대화 상자의 부모 창으로 사용할 창의 핸들입니다.

[in] lpNetResource

네트워크 Connections 대화 상자에서 현재 선택한 항목에 대한 포인터입니다. 공급자는 이 필드를 무시하도록 선택할 수 있습니다.

[out] lpBuffer

검색 결과를 받을 버퍼에 대한 포인터입니다.

[out] cbBuffer

전달된 버퍼의 크기를 지정하는 DWORD입니다.

[in] lpnFlags

대화 상자가 해제된 후 공급자가 특정 작업을 강제로 적용하도록 설정할 수 있는 플래그의 DWORD 에 대한 포인터입니다. 지원되는 유일한 플래그는 WNSRCH_REFRESH_FIRST_LEVEL. 그러면 대화 상자가 해제된 후 MPR이 축소된 다음 이 공급자 아래의 첫 번째 수준을 확장하고 새로 고칩니다.

반환 값

함수가 성공하고 사용자가 확인을 클릭한 경우 NPSearchDialog 는 WN_SUCCESS 반환해야 합니다. 그렇지 않으면 다음 중 하나일 수 있는 오류 값을 반환해야 합니다. 다른 모든 오류는 공급자의 대화 상자에서 직접 처리하거나 보고해야 합니다.

반환 코드 설명
WN_CANCEL
 사용자가 작업을 취소했습니다.
WN_MORE_DATA
 입력 버퍼가 너무 작습니다.

설명

공급자가 열거형을 지원하지 않는 경우 공급자의 항목을 두 번 클릭하는 것과 관련된 작업은 검색 대화 상자를 호출하는 것입니다.

요구 사항

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