NPFormatNetworkName 함수(npapi.h)

  • 아티클

컨트롤에 표시할 네트워크 이름을 공급자별 형식으로 서식을 지정합니다.

구문

DWORD NPFormatNetworkName(
  [in]      LPWSTR  lpRemoteName,
  [out]     LPWSTR  lpFormattedName,
  [in, out] LPDWORD lpnLength,
  [in]      DWORD   dwFlags,
  [in]      DWORD   dwAveCharPerLine
);

매개 변수

[in] lpRemoteName

서식을 지정할 네트워크 이름에 대한 포인터입니다.

[out] lpFormattedName

서식이 지정된 이름을 받는 문자열에 대한 포인터입니다.

[in, out] lpnLength

lpFormattedName 버퍼의 크기를 문자 단위로 지정하는 DWORD에 대한 포인터입니다. 이 함수의 반환 값이 WN_MORE_DATA 경우 lpnLength 에는 필요한 버퍼 크기(문자)가 포함됩니다.

[in] dwFlags

요청되는 형식의 형식을 나타내는 비트 필드입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
WNFMT_MULTILINE
 공급자는 이름에 줄 바꿈이 표시되어야 하는 백슬래시 n(\\n)을 배치해야 합니다. 전체 이름을 표현해야 합니다.
WNFMT_ABBREVIATED
 공급자는 사용자에게 가장 유용한 정보가 사용 가능한 공간에 맞도록 네트워크 이름을 줄여야 합니다.
 

또한 위 플래그의 한정자 역할을 하는 다음 플래그는 비트 OR 연산을 사용하여 포함할 수 있습니다.

값 의미
WNFMT_INENUM
 네트워크 이름은 열거형의 네트워크 이름 바로 앞에 "컨테이너"의 이름이 표시되는 열거형의 컨텍스트에 표시됩니다. 이렇게 하면 네트워크 공급자가 서식이 지정된 이름에서 중복 정보를 제거하여 사용자에게 덜 복잡한 표시를 제공할 수 있습니다.

[in] dwAveCharPerLine

네트워크 이름이 표시되는 한 줄에 맞는 평균 문자 수를 지정합니다. 특히 이 값은 컨트롤의 표시에 사용되는 글꼴에서 TEXTMETRIC 구조의 tmAveCharWidth 필드로 나눈 컨트롤의 너비로 정의됩니다.

반환 값

함수가 성공하면 WN_SUCCESS 반환해야 합니다.

함수가 실패하면 다음 값을 반환해야 합니다. 다른 모든 오류는 무시되고 형식이 지정되지 않은 네트워크 이름이 사용됩니다.

반환 코드 설명
WN_MORE_DATA
 입력 버퍼가 너무 작습니다.

설명

이 함수를 사용하면 네트워크 공급업체가 사용자에게 표시되기 전에 네트워크 이름을 자르거나 수정할 수 있습니다. 예를 들어 일반적인 열기 대화 상자에서 드라이브 콤보 상자에는 연결된 모든 리소스와 연결된 네트워크 이름이 표시됩니다. 각 항목이 표시되기 전에 NPFormatNetworkName 이 호출되고 네트워크 공급자는 콤보 상자에 맞도록 이름을 편집할 수 있습니다. 더 중요한 것은 네트워크 공급자가 이름을 편집하여 네트워크 이름의 가장 중요한 부분을 사용자에게 표시할 수 있습니다.

NPFormatNetworkName은 대부분의 다른 네트워크 공급자 함수와 마찬가지로 각 네트워크 공급자로 라우팅되지 않습니다. 각 네트워크 공급업체는 자체 네트워크 이름 서식 지정에 대해서만 걱정할 필요가 있습니다. 네트워크 공급자 드라이버에서 생성된 이름만 NPFormatNetworkName에 전달된다고 가정할 수 있습니다.

WNFMT_ 플래그는 일반적으로 다음 표에 설명된 대로 사용자 인터페이스의 다양한 위치에서 전달됩니다. 전달되는 플래그에 대해 가정해서는 안 됩니다. 이 테이블은 각 네트워크 공급업체가 네트워크 이름을 수정하는 데 가장 적합한 방법을 결정하는 데 도움이 되도록만 제공됩니다.

표시 위치 WNFMT_ MULTILINE 약어 WNFMT_ WNFMT_ INENUM
파일 관리자 연결 대화 상자, 드라이브 콤보 상자, 선택. (콤보 상자의 선택 영역은 현재 선택 영역을 표시하는 목록 섹션 위의 위쪽 사각형입니다.)   X  
파일 관리자 연결 대화 상자, 드라이브 콤보 상자, 목록. (콤보 상자의 목록 섹션은 콤보 상자의 선택 부분 아래에 표시되는 목록 상자입니다.) X    
파일 관리자, 공유 디렉터리 목록.   X X
파일 관리자 네트워크 드라이브 목록 연결을 끊 습니다. X    
파일 관리자, 도구 모음, 콤보 상자, 선택.   X  
파일 관리자, 도구 모음, 콤보 상자, 목록 X    
일반적인 열기 및 저장 대화 상자, 드라이브 콤보 상자, 선택.   X  
일반적인 열기 및 저장 대화 상자, 드라이브 콤보 상자, 목록.   X  

요구 사항

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