FreePortableDevicePnPIDs 関数

FreePortableDevicePnPIDs ヘルパー関数は、IPortableDeviceManager::GetDevices メソッドまたは IPortableDeviceServiceManager::GetDeviceServices メソッドによって取得されるプラグ アンド プレイ (PnP) 識別子を解放します。

構文

void FreePortableDevicePnPIDs(
   LPWSTR *pPnPIDs,
   DWORD  cPnPIDs
);

パラメーター

pPnPIDs

解放するプラグ アンド プレイ (PnP) 識別子の配列。

cPnPIDs

pPnPIDs パラメーターで指定された配列内の識別子の数。

戻り値

この関数は値を返しません。

注釈

アプリケーションは、割り当てるポインターの配列を解放する役割を担います。

例

// Allocate an array of LPWSTR pointers.
    LPWSTR* pPnpDeviceIDs = new LPWSTR[cPnpDeviceIDs];
if (pPnpDeviceIDs != NULL)
{
    hr = pPortableDeviceManager->;GetDevices(pPnpDeviceIDs, &cPnpDeviceIDs);
    if (SUCCEEDED(hr))
    {
        // Free all returned PnPDeviceID strings allocated by IPortableDeviceManager::GetDevices.
     FreePortableDevicePnPIDs(pPnpDeviceIDs, cPnpDeviceIDs);
     // Application is responsible for deleting the array of LPWSTR pointers.
     delete [] pPnpDeviceIDs;
     pPnpDeviceIDs = NULL;      
 }
} 

要件