HrCreateNewWrappedObject
Создает объект, к которому клиент может получить доступ в предпочтительном символьном формате.
Краткие сведения
Поле | Значение |
---|---|
Экспортировано: |
msmapi32.dll |
Вызывающая сторона: |
Клиент |
Реализовано в: |
Outlook |
HRESULT HrCreateNewWrappedObject(
LPVOID pvUnwrapped,
ULONG ulUnwrappedFlags,
ULONG ulWrappedFlags,
const IID *pIID,
const ULONG *pulReserved,
BOOL fCheckWrap,
LPVOID *ppvWrapped
);
Параметры
pvUnwrapped
[в] Исходный объект Outlook, распакованный. Должен реализовывать один из следующих интерфейсов:
- IMailUser : IMAPIProp, IMAPIFolder : IMAPIContainer, IMessage : IMAPIProp, IMsgStore : IMAPIProp, IMSLogon : IUnknown или IOSTX.
ulUnwrappedFlags
[в] Флаги, характеризующие распакованный исходный объект. Должно быть одно или несколько из следующих значений:
DDLWRAP_FLAG_ANSI — unwrapped object is ANSI.
DDLWRAP_FLAG_UNICODE — unwrapped object is UNICODE.
ulWrappedFlags
[в] Флаги для предпочтительного символьного формата. Должно быть одно или несколько из следующих значений:
- DDLWRAP_FLAG_ANSI — объект в оболочке будет предоставляться как ANSI.
- DDLWRAP_FLAG_UNICODE — объект в оболочке будет предоставляться как ЮНИКОД.
pIID
[в] Идентификатор интерфейса, поддерживаемого объектом unwrapped; установите значение NULL, если это неизвестно.
pulReserved
[в] Этот параметр не используется. Он должен иметь значение NULL.
fCheckWrap
[в] Присвойте этому параметру значение true , если параметр pvUnwrapped должен быть проверен на его формат перед переносом; установите значение false , если объект должен быть упакован без проверки.
ppvWrapped
[out] Указатель на запрошенный объект, заключенный в формат запрошенного символа.
Возвращаемые значения
S_OK if the call succeeded; otherwise, an error code.
Замечания
Передача упакованного объекта с параметром fCheckWrap имеет значение true , приведет к распаковке объекта. Независимо от того, является ли возвращенный объект оболочкой, клиент отвечает за освобождение ссылки на возвращенный объект.
При использовании GetProcAddress для поиска адреса этой функции в msmapi32.dll укажите HrCreateNewWrappedObject@28 в качестве имени процедуры.