Share via

NETRESOURCEW 구조체(winnetwk.h)

  • 아티클

다음 구조에는 네트워크 리소스에 대한 정보가 포함되어 있습니다. NPOpenEnum 및 NPAddConnection을 비롯한 여러 네트워크 공급자 함수에서 사용됩니다.

구문

typedef struct _NETRESOURCEW {
  DWORD  dwScope;
  DWORD  dwType;
  DWORD  dwDisplayType;
  DWORD  dwUsage;
  LPWSTR lpLocalName;
  LPWSTR lpRemoteName;
  LPWSTR lpComment;
  LPWSTR lpProvider;
} NETRESOURCEW, *LPNETRESOURCEW;

멤버

dwScope

열거형의 scope 나타냅니다. 다음 값 중 하나일 수 있습니다.

값 의미
RESOURCE_CONNECTED
 네트워크 리소스에 대한 현재 연결입니다.
RESOURCE_GLOBALNET
 모든 네트워크 리소스 연결되거나 연결되지 않을 수 있습니다.
RESOURCE_CONTEXT
 사용자의 현재 및 기본 네트워크 컨텍스트와 연결된 네트워크 리소스입니다. 이 것의 의미는 공급자별입니다.

dwType

리소스 종류를 나타냅니다. 다음 값 중 하나일 수 있습니다.

값 의미
RESOURCETYPE_DISK
 리소스는 공유 디스크 볼륨입니다.
RESOURCETYPE_PRINT
 리소스는 공유 프린터입니다.
RESOURCETYPE_ANY
 리소스는 인쇄 및 디스크 리소스의 컨테이너 또는 인쇄 또는 디스크가 아닌 리소스와 같은 두 개 이상의 형식과 일치합니다.

dwDisplayType

공급자가 이 리소스를 나타내는 데 사용해야 하는 사용자 인터페이스의 표시 유형을 나타내도록 설정합니다. 다음 형식이 정의됩니다.

값 의미
RESOURCEDISPLAYTYPE_NETWORK
 리소스는 네트워크 공급자입니다.
RESOURCEDISPLAYTYPE_DOMAIN
 리소스는 서버의 컬렉션입니다.
RESOURCEDISPLAYTYPE_SERVER
 리소스가 서버입니다.
RESOURCEDISPLAYTYPE_SHARE
 리소스는 공유 지점입니다.
RESOURCEDISPLAYTYPE_DIRECTORY
 리소스는 디렉터리입니다.
RESOURCEDISPLAYTYPE_GENERIC
 리소스 종류가 지정되지 않았습니다. 이 값은 리소스 종류를 지정하지 않는 네트워크 공급자에서 사용됩니다.

dwUsage

리소스에 대한 정보를 열거하는 방법을 나타내는 비트 마스크입니다. dwScope가 RESOURCE_GLOBALNET 설정된 경우에만 정의됩니다. dwUsage 필드에는 다음 플래그 중 하나 이상이 포함될 수 있습니다.

값 의미
RESOURCEUSAGE_CONNECTABLE
 NPAddConnection을 호출하여 리소스에 연결할 수 있습니다. dwType이 RESOURCETYPE_DISK 경우 리소스에 연결한 후 FindFirstFile 및 FindNextFile과 같은 파일 시스템 API를 사용하여 리소스에 포함된 파일 및 디렉터리를 열거할 수 있습니다.
RESOURCEUSAGE_CONTAINER
 리소스는 NPOpenEnum, NPEnumResource 및 NPCloseEnum 함수를 통해 열거할 수 있는 다른 리소스에 대한 컨테이너 입니다.

그러나 열거형이 만들어질 때 컨테이너가 비어 있을 수 있습니다. 즉, NPEnumResource 에 대한 첫 번째 호출은 WN_NO_MORE_ENTRIES 반환할 수 있습니다.

lpLocalName

dwScope가 RESOURCE_CONNECTED 경우 lpLocalName 필드에 리디렉션된 디바이스의 이름이 포함됩니다. 연결이 디바이스 없는 연결인 경우 이 필드에 는 NULL이 포함됩니다.

dwScope가 RESOURCE_CONNECTED 설정되지 않은 경우 이 필드는 정의되지 않습니다.

lpRemoteName

열거된 항목이 네트워크 리소스인 경우 이 필드에는 원격 네트워크 이름이 포함됩니다. 그런 다음 dwUsage가 RESOURCEUSAGE_CONNECTABLE 설정된 경우 이 이름을 NPAddConnection에 전달하여 네트워크 연결을 만들 수 있습니다. 열거된 항목이 현재 연결인 경우 이 필드는 lpLocalName 이 연결된 원격 네트워크 이름을 참조합니다.

lpComment

열거된 항목과 연결된 공급자 제공 주석일 수 있습니다.

lpProvider

이 열거형 항목을 소유하는 공급자의 이름을 지정합니다.

설명

참고

winnetwk.h 헤더는 NETRESOURCE를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 winnetwk.h