ISpObjectToken::GetId

This method gets the identifier for an object token. This identifier can be used later to recreate a token.

HRESULT GetId(
  WCHAR** ppszCoMemTokenId
);

Parameters

  • ppszCoMemTokenId
    [out] Address of a pointer to a null-terminated string specifying the token identifier. The caller must use CoTaskMemFree to free the object associated with the token.

Return Values

The following table shows the possible return values.

Value Description
S_OK Function completed successfully.
E_POINTER ppszCoMemTokenId is invalid or bad.
E_OUTOFMEMORY Exceeded available memory.
SPERR_UNINITIALIZED TokenId interface is not initialized.
FAILED(hr) Appropriate error message.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: sapi.h, sapi.idl.
Link Library: Sapilib.lib.

See Also

ISpObjectToken | SAPI Interfaces

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.