IStreamBufferInitialize

IStreamBufferInitialize インターフェイスは、stream buffer フィルターを構成するために使用します。Stream Buffer Source フィルター、Stream Buffer Sink フィルター、および StreamBufferConfig オブジェクトはいずれもこのインターフェイスを公開します。

このインターフェイスのインターフェイス識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(IStreamBufferInitialize)。

SetHKEY メソッドは、stream buffer オブジェクトが構成情報を格納するレジストリキーを設定します。

HRESULT を返します。取り得る値には次の表に示すものが含まれます。

このメソッドを使用すると、アプリケーションは stream buffer オブジェクトが構成情報 (バッキングファイルの場所、バッキングファイルの数、およびそのサイズを含む) を保存するレジストリキーを指定できます。

このメソッドは、オブジェクトが明示的または暗黙的に初期化される前に呼び出す必要があります。Stream Buffer Sink フィルターの場合は、プロファイルがロックされる前にメソッドを呼び出します。Stream Buffer Source フィルターの場合は、ソースファイル名を設定する前にメソッドを呼び出します。

このメソッドを使用するには、次の手順を実行します。

1. 新しいレジストリキーを作成するか、既存のキーを開きます。
2. StreamBufferConfig オブジェクトのインスタンスを作成します。
3. StreamBufferConfig オブジェクトに対して IStreamBufferInitialize インターフェイスをクエリします。
4. レジストリキーへのハンドルを指定して、StreamBufferConfig オブジェクトに対して SetHKey を呼び出します。
5. 必要に応じて、IStreamBufferConfigure メソッドを呼び出して、レジストリキーに格納される構成情報を変更します。
6. 同じレジストリキーを使用して、Stream Buffer Source フィルターと Stream Buffer Sink フィルターに対して SetHKey を呼び出します。

呼び出し側は、このメソッドを呼び出した後にレジストリキーハンドルを解放してかまいません。

例

次のコードは、バッキングファイルのディレクトリを構成する方法を示します。簡潔にするため、エラーチェックは省略しています。

// Create the StreamBufferConfig object.
CComPtr<IStreamBufferConfigure> pConfig;
hr = pConfig.CoCreateInstance(CLSID_StreamBufferConfig);

// Create a new registry key to hold our settings.
HKEY hkey = 0;
long lRes = RegCreateKey(HKEY_LOCAL_MACHINE,
    TEXT("SOFTWARE\\MyStreamBufferKey"), &hkey);

// Set the registry key.
CComPtr<IStreamBufferInitialize> pInit;
hr = pConfig.QueryInterface(&pInit);
hr = pInit->SetHKEY(hkey);
pInit.Release();

// Set the backing file directory.
hr = pConfig->SetDirectory(L"C:\\MyDirectory");

// Create the Stream Buffer Sink filter and set the registry key.
CComPtr<IStreamBufferSink> pSink;
hr = pSink.CoCreateInstance(CLSID_StreamBufferSink);
hr = pSink.QueryInterface(&pInit);
hr = pInit->SetHKEY(hkey);
pInit.Release();

// Create the Stream Buffer Source filter and set the registry key.
CComPtr<IStreamBufferSource> pSource;
hr = pSource.CoCreateInstance(CLSID_StreamBufferSource);
hr = pSource.QueryInterface(&pInit);
hr = pInit->SetHKEY(hkey);

SetSIDs メソッドは、バッキングファイルへのアクセスを保護するために使用されるセキュリティ識別子 (SID) を設定します。

HRESULT を返します。取り得る値には次の表に示すものが含まれます。

実行時に、Stream Buffer Source フィルターと Sink フィルターは、バッキングファイルへのアクセスがスレッド間で同期されるように、ミューテックスなどのさまざまな Win32 オブジェクトを作成します。各フィルターは、これらのオブジェクトを保護するために使用される SID のリストを保持しています。既定では、フィルターはホストプロセスから SID を継承します。アプリケーションは SetSIDs メソッドを使用して、既定の SID を上書きできます。

このメソッドを呼び出す場合は、sink フィルターをロックする前、またはソースフィルターでファイルを読み込む前に呼び出してください。すべてのフィルターに同じ SID を与えることをお勧めします。

• 重要 権限の低い SID を設定すると、セキュリティ上の問題が生じる可能性があります。