DeviceProperties_RunDLL 함수 프로토타입

DeviceProperties_RunDLL 함수는 로컬 또는 원격 컴퓨터에 설치된 지정된 디바이스에 대한 디바이스 속성 대화 상자를 엽니다.

void DeviceProperties_RunDLL(
  HWND       hwndStub,
  HINSTANCE  hAppInstance,
  LPCTSTR    lpCmdLine,
  int        nCmdShow
  );

매개 변수

hwndStub
DeviceProperties_RunDLL 만드는 사용자 인터페이스 항목을 표시할 창에 대한 핸들입니다.

hAppInstance
이 매개 변수는 디바이스 속성 대화 상자를 호출하는 데 사용되지 않으며 NULL로 설정해야 합니다.

lpCmdLine
컴퓨터 이름 매개 변수 필드와 다음 형식의 device-instance-ID-parameter 필드가 포함된 상수 NULL 종료 명령줄 문자열에 대한 포인터입니다.

machine-name-parameter device-instance-ID-parameter

machine-name-parameter
machine-name-parameter 필드는 device-instance-ID-parameter 필드에 지정된 디바이스와 연결된 컴퓨터의 이름을 제공합니다. machine-name-parameter 필드의 형식은 /MachineNamemachine-name **** 입니다. 여기서 /MachineName은 컴퓨터 이름이 컴퓨터 이름을 제공한다는 것을 나타냅니다. 컴퓨터 이름 매개 변수 필드에 대한 자세한 내용은 설명 섹션을 참조하세요.

device-instance-ID-parameter
device-instance-ID-parameter 필드는 디바이스 속성 대화 상자를 표시할 디바이스의 디바이스 인스턴스 식별자를 제공합니다. device-instance-ID-parameter 필드의 형식은 /DeviceIddevice-instance-ID **** 입니다. 여기서 /DeviceId는device-instance-ID가 디바이스 인스턴스 식별자를 제공했음을 나타냅니다. device-instance-ID-parameter 필드가 필요합니다.

nCmdShow
이 매개 변수는 디바이스 속성 대화 상자를 호출하는 데 사용되지 않으며 NULL로 설정해야 합니다.

반환 값

없음

헤더

DeviceProperties_RunDLL 공용 헤더에 선언되지 않으며 프로그래밍 방식으로 함수에 대한 포인터를 가져오거나 rundll32를 사용하여 간접적으로 호출할 수 있습니다.

설명

Windows XP에서 컴퓨터 이름 매개 변수 필드는 원격 컴퓨터에만 필요하며 컴퓨터 이름 매개 변수 필드를 제공하지 않으면 로컬 컴퓨터가 기본적으로 사용됩니다. Windows 2000에서는 로컬 컴퓨터 또는 원격 컴퓨터에 컴퓨터 이름 매개 변수 필드가 필요합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름 매개 변수 필드의 컴퓨터 이름을 따옴표 쌍("")으로 설정합니다. 컴퓨터가 원격 컴퓨터인 경우 컴퓨터 이름을 유효한 컴퓨터 이름으로 설정합니다. 유효한 컴퓨터 이름에는 한 쌍의 backslashes(\) 뒤에 컴퓨터 이름으로 구성된 접두사가 포함되어야 합니다.

다음은 명령줄 문자열의 예입니다.

• (Windows XP 이상) 로컬 컴퓨터를 지정하는 것은 선택 사항입니다. 이 경우 명령줄 문자열은 디바이스 인스턴스 식별자만 포함해야 합니다. 예를 들어 다음 명령줄은 기본적으로 로컬 컴퓨터와 디바이스 인스턴스 식별자 "root\system\0000"을 지정합니다.

  /DeviceId root\system\0000
  

• (Windows 2000 이상) 다음 명령줄 문자열은 원격 컴퓨터 이름 "\\RemoteMachineAbc"와 디바이스 인스턴스 식별자 "root\system\0000"을 제공합니다.

  /MachineName \\RemoteMachineAbc /DeviceId root\system\0000
  

• (Windows 2000 이상) 다음 명령줄 문자열은 따옴표 쌍("")으로 지정된 로컬 컴퓨터를 지정하고 디바이스 인스턴스 식별자 "root\system\0000"을 제공합니다.

  /MachineName "" /DeviceId root\system\0000