NPPropertyDialog 함수(npapi.h)

사용자가 NPPropertyDialog 함수를 사용하여 추가된 단추를 클릭할 때 호출됩니다. NPPropertyDialog 함수는 파일 및 디렉터리 네트워크 속성에 대해서만 호출됩니다.

구문

DWORD NPPropertyDialog(
  [in] HWND   hwndParent,
  [in] DWORD  iButtonDlg,
  [in] DWORD  nPropSel,
  [in] LPWSTR lpFileName,
  [in] DWORD  nType
);

매개 변수

[in] hwndParent

파일 속성 대화 상자를 소유해야 하는 부모 창에 대한 핸들입니다.

[in] iButtonDlg

누른 단추의 인덱스입니다.

이 인덱스는 요청된 속성 대화 상자를 NPGetPropertyText 함수에서 반환된 첫 번째 단추에 대해 1개부터 지정합니다. 여러 파일 이름이 선택된 경우 이 번호에 10이 추가됩니다. 즉, 둘 이상의 파일이 선택되어 있고 사용자가 첫 번째 공급자 정의 속성 단추를 누르면 iButtonDlg 는 11이 됩니다. 선택한 파일이 하나만 있고 사용자가 두 번째 네트워크 속성 단추를 누르면 iButtonDlg 는 2가 됩니다.

[in] nPropSel

속성 대화 상자가 작동해야 하는 항목을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
WNPS_FILE	단일 파일입니다.
WNPS_DIR	단일 디렉터리입니다.
WNPS_MULT	여러 파일, 디렉터리 또는 둘 다의 선택입니다.

[in] lpFileName

속성 대화 상자가 작동해야 하는 항목의 이름에 대한 포인터입니다. 지원되는 항목은 파일 및 디렉터리뿐이므로 항목 이름은 파일 이름입니다. 이러한 문자는 명확하고 와일드카드 문자를 포함하지 않으며 정규화되어야 합니다(예 : C:\Local\Example.doc). 여러 파일 이름은 공백으로 구분해야 합니다. 공백이 포함된 파일 이름은 따옴표로 묶을 수 있습니다(예 : "C:\My File"). 이 경우 단일 이름으로 처리됩니다. 캐럿(^)을 단일 문자에 대한 따옴표 메커니즘으로 사용할 수도 있습니다. 예를 들어 C:\My^"File 및 "C:\My^"File"은 모두 C:\My" 파일을 참조합니다.

[in] nType

WNTYPE_FILE 항목 유형을 지정합니다.

반환 값

함수가 성공하면 WN_SUCCESS 반환합니다. 함수가 실패하면 오류 코드를 반환합니다. SetLastError를 호출하여 다음 반환 코드를 포함할 수 있는 이 확장 오류 코드를 설정합니다.

반환 코드	설명
WN_BAD_VALUE	하나 이상의 매개 변수가 예기치 않은 형식 또는 값입니다.
WN_OUT_OF_MEMORY	대화 상자를 표시할 메모리가 부족합니다.
WN_NET_ERROR	네트워크 오류가 발생했습니다.

설명

이 함수는 NPGetPropertyText 에 단추 이름이 할당된 속성 집합에서만 호출됩니다.

이 함수는 파일 관리자에서 네트워크 디바이스의 파일에 대한 네트워크 속성(예: 권한)을 보고 수정하는 데 사용됩니다. 이 함수가 지원되지 않는 경우 파일 관리자는 기본 동작을 제공하지 않습니다.

이 버전의 네트워크 공급자 인터페이스에서 lpFileName 은 파일 이름만 가리킬 수 있습니다. 네트워크 공급자는 부적절한 디바이스가 표시되면 WN_BAD_VALUE 반환해야 합니다.

요구 사항

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

추가 정보

NPGetPropertyText

SetLastError