Microsoft SDK for Java

ParseDisplayName

This method of the IParseDisplayName interface parses the display name to extract a component of the string that it can convert into a moniker by using the maximum number of characters from the left side of the string.

Syntax

public IMoniker ParseDisplayName(IBindCtx pbc, String pszDisplayName, int[] pchEaten);

Return Values

This method supports the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following:

S_OK -- The parse operation was successful.

MK_E_SYNTAX -- Syntax error in the display name. Parsing failed because szDisplayName could only be partially resolved into a moniker. In this case, *pchEaten has the number of characters that were successfully parsed into a moniker prefix. The parameter ppmkOut should be NULL.

MK_E_NOOBJECT -- The display name does not identify a component in this namespace.

E_INVALIDARG -- One or more parameters are invalid.

Parameters

[in] pbc The pointer to the bind context to be used in this binding operation.
[in] pszDisplayName The pointer to a zero-terminated string containing the display name to be parsed. For Microsoft® Win32® applications, the LPOLESTR type indicates a wide character string (two bytes per character); otherwise, the string has one byte per character.
[out] pchEaten The pointer to the number of characters in the display name.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.