HidD_GetSerialNumberString 함수(hidsdi.h)
HidD_GetSerialNumberString 루틴은 컬렉션의 물리적 디바이스 일련 번호를 식별하는 최상위 컬렉션의 포함된 문자열을 반환합니다.
구문
BOOLEAN HidD_GetSerialNumberString(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
매개 변수
[in] HidDeviceObject
최상위 컬렉션에 대한 열린 핸들을 지정합니다.
[out] Buffer
루틴이 요청된 일련 번호 문자열을 반환하는 데 사용하는 호출자 할당 버퍼에 대한 포인터입니다. 루틴은 NULL로 끝나는 와이드 문자열을 반환합니다.
[in] BufferLength
버퍼에 제공된 호출자 할당 버퍼의 길이(바이트)를 지정합니다. 버퍼가 NULL로 종료된 전체 포함된 문자열을 반환할 만큼 크지 않은 경우 루틴은 버퍼에 아무 것도 반환하지 않습니다. 제공된 버퍼는 = 4093바이트(2^12 – 3)여야 합니다 <.
반환 값
HidD_GetSerialNumberString NULL로 종료된 전체 포함된 문자열을 성공적으로 반환하면 TRUE 를 반환합니다. 그렇지 않으면 루틴이 FALSE를 반환 합니다. GetLastError를 사용하여 확장된 오류 정보를 가져옵니다.
설명
사용자 모드 애플리케이션만 HidD_GetSerialNumberString 호출할 수 있습니다. 커널 모드 드라이버는 IOCTL_HID_GET_SERIALNUMBER_STRING 사용할 수 있습니다.
포함된 문자열에서 가능한 최대 문자 수는 디바이스별로 다릅니다. USB 디바이스의 경우 최대 문자열 길이는 126자입니다(종결 NULL 문자는 포함하지 않음).
제공된 버퍼가 = 4093바이트(2^12 – 3)가 아닌 <경우 오류 코드 ERROR_GEN_FAILURE(0x0000001f)이 있는 기본 프로토콜 HID/Bluetooth/SPI에 따라 호출이 실패할 수 있습니다.
자세한 내용은 HID 컬렉션을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | hidsdi.h(Hidsdi.h 포함) |
| 라이브러리 | Hid.lib |
| DLL | Hid.dll |