NPGetPropertyText 함수(npapi.h)

  • 아티클

네트워크 리소스의 속성 대화 상자에 추가할 단추의 이름을 검색합니다.

구문

DWORD NPGetPropertyText(
  [in]      DWORD  iButton,
  [in]      DWORD  nPropSel,
  [in]      LPWSTR lpName,
  [out]     LPWSTR lpButtonName,
  [in, out] DWORD  nButtonNameLen,
  [in]      DWORD  nType
);

매개 변수

[in] iButton

단추의 인덱스입니다. 파일 관리자는 최대 6개의 단추를 지원합니다. 이 매개 변수는 하나의 파일만 선택한 경우 가능한 각 단추에 대해 1-6으로 번호가 매겨지거나 여러 파일이 선택된 경우 11-16으로 번호가 매겨집니다.

[in] nPropSel

속성 대화 상자에서 중점을 두는 항목을 지정합니다. 다음 값 중 하나일 수 있습니다.

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

[in] lpName

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

[out] lpButtonName

네트워크 공급자가 속성 단추의 이름을 복사해야 하는 버퍼에 대한 포인터입니다. 성공하면 lpButtonName 이 가리키는 버퍼에 속성 단추의 이름이 포함됩니다. 이 버퍼가 종료될 때 빈 문자열을 포함하는 경우 해당 이름 및 모든 성공 단추에 해당하는 단추가 대화 상자에서 제거됩니다. 네트워크 공급자는 단추를 "건너뛸" 수 없습니다.

[in, out] nButtonNameLen

종료 null 문자를 포함하여 lpButtonName 버퍼의 크기를 문자로 지정합니다.

[in] nType

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

반환 값

함수가 성공하면 WN_SUCCESS 반환해야 하며 lpButtonName 을 사용할 수 있습니다. 빈 문자열을 가리키는 경우 iButton만큼 높은 인덱스에 해당하는 단추가 없습니다. 반환 값이 WN_SUCCESS 이외의 경우 공급자는 SetLastError 를 호출하여 확장된 오류 정보를 설정해야 합니다. 확장 오류 코드에는 다음이 포함됩니다.

반환 코드 설명
WN_OUT_OF_MEMORY
 리소스에서 문자열을 로드할 수 없습니다.
WN_MORE_DATA
 지정된 버퍼가 너무 작아서 단추의 텍스트에 맞지 않습니다.
WN_BAD_VALUE
 lpName 매개 변수는 예기치 않은 형식입니다.
WN_NOT_SUPPORTED
 지정된 개체 형식인 nType에는 속성 대화 상자가 지원되지 않습니다.

설명

파일 관리자는 속성 대화 상자가 표시 될 때마다이 함수를 호출 하 고 대화 상자를 표시하기 전에이 작업을 수행 합니다. 사용자가 네트워크 공급자가 이 함수를 통해 추가한 단추를 클릭하면 적절한 매개 변수를 사용하여 NPPropertyDialog 함수가 호출됩니다.

파일 관리자만 NPGetPropertyText를 호출하고 파일 및 디렉터리에 이 함수를 사용합니다.

요구 사항

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