INetwork 인터페이스(netlistmgr.h)
INetwork 인터페이스는 로컬 컴퓨터의 네트워크를 나타냅니다. 또한 비슷한 네트워크 서명이 있는 네트워크 연결 컬렉션을 나타낼 수도 있습니다.
상속
INetwork 인터페이스는 IUnknown 인터페이스에서 상속됩니다. INetwork 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
INetwork 인터페이스에는 이러한 메서드가 있습니다.
| INetwork::get_IsConnected get_IsConnected 속성은 네트워크에 네트워크 연결이 있는지를 지정합니다. |
| INetwork::get_IsConnectedToInternet get_IsConnectedToInternet 속성은 네트워크에 인터넷 연결이 있는지를 지정합니다. |
| INetwork::GetCategory GetCategory 메서드는 네트워크의 범주를 반환합니다. |
| INetwork::GetConnectivity GetConnectivity 메서드는 네트워크의 연결 상태를 반환합니다. |
| INetwork::GetDescription GetDescription 메서드는 네트워크에 대한 설명 문자열을 반환합니다. |
| INetwork::GetDomainType GetDomainType 메서드는 네트워크의 도메인 형식을 반환합니다. |
| INetwork::GetName GetName 메서드는 네트워크 이름을 반환합니다. |
| INetwork::GetNetworkConnections GetNetworkConnections 메서드는 네트워크에 대한 모든 네트워크 연결의 열거형을 반환합니다. 네트워크는 서로 다른 인터페이스 또는 동일한 인터페이스의 다른 링크에서 여러 연결을 가질 수 있습니다. |
| INetwork::GetNetworkId GetNetworkId 메서드는 네트워크의 고유 식별자를 반환합니다. |
| INetwork::GetTimeCreatedAndConnected GetTimeCreatedAndConnected 메서드는 네트워크를 만들고 연결한 로컬 날짜와 시간을 반환합니다. |
| INetwork::SetCategory SetCategory 메서드는 네트워크의 범주를 설정합니다. 변경 내용이 즉시 적용됩니다. 이 API의 호출자는 Administrators 그룹의 구성원이어야 합니다. |
| INetwork::SetDescription SetDescription 메서드는 네트워크에 대한 설명을 설정하거나 바꿉니다. |
| INetwork::SetName SetName 메서드는 네트워크를 설정하거나 이름을 바꿉니다. |
설명
INetwork를 구현하는 COM 개체는 추가 속성에 대한 속성 모음도 구현합니다. 이 속성 모음에 액세스하려면 INetwork 인터페이스 및 IPropertyBag용 QueryInterface를 사용할 수 있습니다. 이 COM 개체의 속성 모음에는 다음 속성이 포함됩니다.
| 매개 변수 | 형식 | Description |
|---|---|---|
| NA_DomainAuthenticationFailed | VT_BOOL | 도메인 네트워크가 도메인 컨트롤러에 대해 인증할 수 없도록 지정합니다. |
| NA_NetworkClass | VT_UINT 저장된 NLM_NETWORK_CLASS 값 | 네트워크의 클래스를 지정합니다. 가능한 값은 다음과 같습니다.
|
|
NA_InternetConnectivityV4 또는 NA_InternetConnectivityV6 |
VT_UINT 저장된 NLM_INTERNET_CONNECTIVITY 값 |
IPv4 또는 IPv6 네트워크 연결에 대한 세부 정보를 제공합니다. 가능한 값은 다음과 같습니다.
|
| NA_NameSetByPolicy | VT_BOOL | 네트워크 이름이 그룹 정책에 의해 설정되었습니다. |
| NA_IconSetByPolicy | VT_BOOL | 네트워크 아이콘이 그룹 정책에 의해 설정되었습니다. |
| NA_DescriptionSetByPolicy | VT_BOOL | 네트워크에 대한 설명은 그룹 정책에 의해 설정되었습니다. |
| NA_CategorySetByPolicy | VT_BOOL | 네트워크 범주가 그룹 정책에 의해 설정되었습니다. |
| NA_NameReadOnly | VT_BOOL | 네트워크 이름은 읽기 전용입니다. |
| NA_IconReadOnly | VT_BOOL | 네트워크의 아이콘은 읽기 전용입니다. |
| NA_DescriptionReadOnly | VT_BOOL | 네트워크에 대한 설명은 읽기 전용입니다. |
| NA_CategoryReadOnly | VT_BOOL | 네트워크의 범주는 읽기 전용입니다. |
| NA_AllowMerge | VT_BOOL | 네트워크를 다른 네트워크와 병합할 수 있습니다. |
IPropertyBag 인터페이스는 IPropertyBag::Read 및 IPropertyBag::Write 메서드의 일부로 LPCOLESTR을 허용합니다. 편의를 위해 이러한 속성에 대한 문자열 값은 동일한 이름을 사용하여 netlistmgr.h 내에 정의됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | netlistmgr.h |