IPersistStream - URL Moniker Implementation
The URL moniker implementation of IPersistStream is found on an URL moniker object, which supports IUnknown, IAsyncMoniker Interface, and IMoniker. The IMoniker interface inherits its definition from IPersistStream and thus, the URL moniker also provides an implementation of IPersistStream as part of its implementation of IMoniker.
The IAsyncMoniker interface on an URL moniker is simply IUnknown (there are no additional methods); it is used to allow clients to determine if a moniker supports asynchronous binding. To get a pointer to the IMoniker interface on this object, call the CreateURLMoniker function. Then, to get a pointer to IPersistStream, call the QueryInterface method.
IPersistStream, in addition to inheriting its definition from IUnknown, also inherits the single method of IPersist, GetClassID.
Note
The current URL Moniker implementation of IMoniker does not support asynchronous storage. Future implementations will do so.
When to Use
Call IPersistStream to have the moniker manage its persistent storage.
Remarks
- IPersistStream::GetClassID
Returns CLSID_StdURLMoniker.
- IPersistStream::IsDirty
Returns S_OK if the Moniker has changed since it was last saved (IPersistStream::Save with *fClearDirty==*TRUE), S_FALSE otherwise.
- IPersistStream::Load
Initializes an URL moniker from data within a stream, usually stored there previously using its IPersistStream::Save (via OleSaveToStream or OleSaveToStreamEx). The binary format of the URL Moniker is its URL string in Unicode (may be a full or partial URL string, see CreateURLMoniker for details). This is represented as a ULONG (32-bit) count of characters followed by that many Unicode characters.
- IPersistStream::Save
Saves an URL moniker to a stream. The binary format of URL Moniker is its URL string in Unicode (may be a full or partial URL string, see CreateURLMoniker for details). This is represented as a ULONG (32-bit) count of characters followed by that many Unicode characters.
- IPersistStream::GetSizeMax
Returns the maximum number of bytes in the stream that will be required by a subsequent call to IPersistStream::Save. This value is SIZEOF(ULONG)==4 plus SIZEOF(WCHAR)*n where n is the length of the full or partial URL string including the NULL terminator.