NETRESOURCEA 구조체(winnetwk.h)
다음 구조에는 네트워크 리소스에 대한 정보가 포함되어 있습니다. NPOpenEnum 및 NPAddConnection을 비롯한 여러 네트워크 공급자 함수에서 사용됩니다.
구문
typedef struct _NETRESOURCEA {
DWORD dwScope;
DWORD dwType;
DWORD dwDisplayType;
DWORD dwUsage;
LPSTR lpLocalName;
LPSTR lpRemoteName;
LPSTR lpComment;
LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;
멤버
dwScope
열거형의 scope 나타냅니다. 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
네트워크 리소스에 대한 현재 연결입니다. |
|
모든 네트워크 리소스 연결되거나 연결되지 않을 수 있습니다. |
|
사용자의 현재 및 기본 네트워크 컨텍스트와 연결된 네트워크 리소스입니다. 이 것의 의미는 공급자별입니다. |
dwType
리소스 종류를 나타냅니다. 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
리소스는 공유 디스크 볼륨입니다. |
|
리소스는 공유 프린터입니다. |
|
리소스는 인쇄 및 디스크 리소스의 컨테이너 또는 인쇄 또는 디스크가 아닌 리소스와 같은 두 개 이상의 형식과 일치합니다. |
dwDisplayType
공급자가 이 리소스를 나타내는 데 사용해야 하는 사용자 인터페이스의 표시 유형을 나타내도록 설정합니다. 다음 형식이 정의됩니다.
dwUsage
리소스에 대한 정보를 열거하는 방법을 나타내는 비트 마스크입니다. dwScope가 RESOURCE_GLOBALNET 설정된 경우에만 정의됩니다. dwUsage 필드에는 다음 플래그 중 하나 이상이 포함될 수 있습니다.
값 | 의미 |
---|---|
|
NPAddConnection을 호출하여 리소스에 연결할 수 있습니다. dwType이 RESOURCETYPE_DISK 경우 리소스에 연결한 후 FindFirstFile 및 FindNextFile과 같은 파일 시스템 API를 사용하여 리소스에 포함된 파일 및 디렉터리를 열거할 수 있습니다. |
|
리소스는 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 |