NETINFOSTRUCT 구조체(winnetwk.h)

NETINFOSTRUCT 구조에는 WNetGetNetworkInformation 함수에서 반환된 네트워크 공급자를 설명하는 정보가 포함되어 있습니다.

구문

typedef struct _NETINFOSTRUCT {
  DWORD     cbStructure;
  DWORD     dwProviderVersion;
  DWORD     dwStatus;
  DWORD     dwCharacteristics;
  ULONG_PTR dwHandle;
  WORD      wNetType;
  DWORD     dwPrinters;
  DWORD     dwDrives;
} NETINFOSTRUCT, *LPNETINFOSTRUCT;

멤버

cbStructure

형식:DWORD

NETINFOSTRUCT 구조체의 크기(바이트)입니다. 호출자는 전달된 구조체의 크기를 나타내기 위해 이 값을 제공해야 합니다. 반환 시 구조체의 크기가 채워집니다.

dwProviderVersion

형식:DWORD

네트워크 공급자 소프트웨어의 버전 번호입니다.

dwStatus

형식:DWORD

네트워크 공급자 소프트웨어의 현재 상태. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
NO_ERROR	네트워크가 실행 중입니다.
ERROR_NO_NETWORK	네트워크를 사용할 수 없습니다.
ERROR_BUSY	네트워크는 현재 요청을 처리할 수 없지만 곧 사용할 수 있게 됩니다. (이 값은 일반적으로 네트워크가 시작 중임을 나타냅니다.)

dwCharacteristics

형식:DWORD

네트워크 공급자 소프트웨어의 특징.

이 값은 0입니다.

Windows Me/98/95: 이 멤버는 다음 값 중 하나 이상일 수 있습니다.

값	의미
NETINFO_DLL16	네트워크 공급자가 16비트 Windows 네트워크 드라이버로 실행되고 있습니다.
NETINFO_DISKRED	네트워크 공급자는 서버 파일 시스템에 액세스하기 위해 리디렉션된 로컬 디스크 드라이브 디바이스가 필요합니다.
NETINFO_PRINTERRED	네트워크 공급자는 서버 파일 시스템에 액세스하기 위해 리디렉션된 로컬 프린터 포트가 필요합니다.

dwHandle

형식: ULONG_PTR

네트워크 공급자 또는 16비트 Windows 네트워크 드라이버에 대한 instance 핸들입니다.

wNetType

형식: WORD

실행 중인 네트워크에 고유한 네트워크 유형입니다. 이 값은 리소스가 영구적이거나 링크에 저장되는 경우 리소스를 특정 네트워크와 연결합니다. 헤더 파일 Winnetwk.h에서 네트워크 유형의 전체 목록을 찾을 수 있습니다.

dwPrinters

형식:DWORD

LPT1에 해당하는 하위 비트가 있는 로컬 프린터 디바이스를 리디렉션하기 위한 유효한 인쇄 번호를 나타내는 비트 플래그 집합입니다.

Windows Me/98/95: 이 값은 항상 –1로 설정됩니다.

dwDrives

형식:DWORD

A:에 해당하는 하위 비트가 있는 디스크 드라이브를 리디렉션하기 위한 유효한 로컬 디스크 디바이스를 나타내는 비트 플래그 집합입니다.

Windows Me/98/95: 이 값은 항상 –1로 설정됩니다.

설명

NETINFOSTRUCT 구조에는 네트워크 공급자 소프트웨어 버전 및 네트워크의 현재 상태 같이 네트워크를 설명하는 정보가 포함되어 있습니다.

요구 사항

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

추가 정보

WNetGetNetworkInformation

WNet(Windows 네트워킹) 개요

Windows 네트워킹 구조