NdfCreateGroupingIncident 함수(ndfapi.h)
NdfCreateGroupingIncident 함수는 피어 투 피어 그룹화 기능 문제를 진단하는 세션을 만듭니다.
구문
HRESULT NdfCreateGroupingIncident(
[in, optional] LPCWSTR CloudName,
[in, optional] LPCWSTR GroupName,
[in, optional] LPCWSTR Identity,
[in, optional] LPCWSTR Invitation,
[in, optional] SOCKET_ADDRESS_LIST *Addresses,
[in, optional] LPCWSTR appId,
[out] NDFHANDLE *handle
);
매개 변수
[in, optional] CloudName
형식: LPCWSTR
그룹이 만들어지는 PNRP(피어 이름 확인 프로토콜) 클라우드의 이름입니다. NULL인 경우 세션은 PNRP와 관련된 문제를 진단하려고 시도하지 않습니다.
[in, optional] GroupName
형식: LPCWSTR
진단할 그룹의 이름입니다. NULL인 경우 세션은 그룹 가용성과 관련된 문제를 진단하려고 시도하지 않습니다.
[in, optional] Identity
형식: LPCWSTR
피어가 그룹에 액세스하는 데 사용하는 ID입니다. NULL인 경우 세션은 PNRP에 등록하는 그룹의 기능과 관련된 문제를 진단하려고 시도하지 않습니다.
[in, optional] Invitation
형식: LPCWSTR
다른 피어가 부여한 XML 초대입니다. 초대하는 피어가 PeerGroupCreateInvitation 또는 PeerGroupIssueCredentials를 호출할 때 초대가 생성됩니다. 이 값이 있으면 초대가 확인되어 해당 형식과 만료가 유효한지 확인합니다.
[in, optional] Addresses
형식: SOCKET_ADDRESS_LIST*
애플리케이션이 연결하려는 피어의 주소 목록(선택 사항)입니다. 이 매개 변수를 사용하는 경우 도우미 클래스는 이러한 주소에 대한 연결을 진단합니다.
[in, optional] appId
형식: LPCWSTR
호출 애플리케이션에 대한 애플리케이션 ID입니다.
[out] handle
형식: NDFHANDLE*
네트워크 진단 프레임워크 인시던트에 대한 핸들입니다.
반환 값
형식: HRESULT
가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드 | Description |
|---|---|
|
작업에 성공했습니다. |
|
하나 이상의 매개 변수가 올바르게 제공되지 않았습니다. |
설명
수행되는 진단 수준은 제공된 매개 변수에 따라 달라집니다.
- 매개 변수가 지정되지 않은 경우 NDF는 그룹화 서비스 상태, PNRP 및 Identity Manager(피어 투 피어 서비스) 상태 및 Windows 클록 동기화의 유효성을 검사합니다.
- CloudName을 지정하면 NDF는 해당 클라우드의 그룹화 기능의 유효성을 검사합니다.
- GroupName을 지정하면 NDF는 이름을 PNRP에서 확인할 수 있는지 확인하고(또는 이름을 확인할 수 없는 경우 PNRP 도우미 클래스를 호출) 그룹화에 대한 방화벽 설정의 유효성을 검사합니다.
- ID를 지정하면 NDF는 이 ID에 GroupName을 등록하는 PNRP의 기능의 유효성을 검사합니다. 실패하면 PNRP 도우미 클래스가 호출됩니다.
- 초대를 지정하면 GroupName은 초대에서 파생되고(GroupName도 지정되지 않은 경우) NDF는 초대 형식의 유효성을 검사하고 상태.
- 주소가 지정된 경우 NDF는 Windows가 이러한 주소 중 최대 3개에 연결할 수 있는지 여부를 확인합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ndfapi.h |
| 라이브러리 | Ndfapi.lib |
| DLL | Ndfapi.dll |