IWCNDevice::SetNetworkProfile 메서드(wcndevice.h)

IWCNDevice::SetNetworkProfile 메서드는 디바이스에 프로비전할 XML WLAN 프로필을 큐에 대기합니다. 이 메서드는 IWCNDevice::Connect 이전에만 호출할 수 있습니다.

구문

HRESULT SetNetworkProfile(
  [in] LPCWSTR pszProfileXml
);

[in] pszProfileXml

XML WLAN 프로필 XML 문자열입니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
S_OK	특성이 성공적으로 검색되었습니다.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	WLAN 프로필은 WCN 연결에 대해 지원되지 않습니다.
HRESULT_FROM_WIN32(ERROR_BAD_PROFILE)	제공된 XML 프로필을 읽을 수 없습니다.

현재 WCNAPI(Windows Connect Now API)는 다음 프로필 유형을 지원합니다.

지정된 WLAN 프로필에 불필요한 설정(예: IHV 설정)이 있는 경우 이러한 설정은 무시됩니다. WLAN 프로필이 WCNAPI와 호환되지 않는 경우 HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) 값이 반환됩니다.