INetworkListManager::GetNetworkConnection 메서드(netlistmgr.h)

  • 아티클

GetNetworkConnection 메서드는 제공된 네트워크 연결 ID를 기반으로 네트워크를 검색합니다.

구문

HRESULT GetNetworkConnection(
  [in]          GUID               gdNetworkConnectionId,
  [out, retval] INetworkConnection **ppNetworkConnection
);

매개 변수

[in] gdNetworkConnectionId

네트워크 연결 ID를 지정하는 GUID 입니다.

[out, retval] ppNetworkConnection

제공된 gdNetworkConnectionId와 연결된 INetworkConnection 개체에 대한 포인터에 대한 포인터입니다.

반환 값

메서드가 성공하면 S_OK를 반환합니다. 그렇지 않으면 메서드는 다음 값 중 하나를 반환합니다.

반환 코드 설명
S_FALSE
 지정된 네트워크 연결 ID와 연결된 네트워크를 찾을 수 없습니다.
E_POINTER
 전달된 포인터가 NULL입니다.
E_UNEXPECTED
 지정한 GUID가 잘못되었습니다.

설명

이 메서드는 지정된 ID와 연결된 네트워크 연결이 제거된 경우 S_FALSE 반환할 수 있습니다. 예를 들어 클라이언트가 네트워크 연결 ID와 함께 INetworkConnectionEvents::NetworkConnectionConnectivityChanged 이벤트를 수신할 수 있지만, INetworkListManager::GetNetworkConnection 이 제공된 ID로 호출될 때 네트워크 연결이 끊어졌거나 대체된 것을 확인할 수 있습니다.

요구 사항

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

추가 정보

INetworkConnection

INetworkListManager