<div class="content"><p> </p><p>The NspiGetIDsFromNames method returns a list of <span><a href="1b8009c5-72bc-41da-bbab-612b31da4410#gt_7eb84614-827d-4b68-a71c-dd94eb0ad27f" data-linktype="relative-path">proptags</a></span>
for a set of property names.</p><dl>
<dd>
<div><pre> long NspiGetIDsFromNames(
   [in] NSPI_HANDLE hRpc,
   [in] DWORD Reserved,
   [in] DWORD dwFlags,
   [in, range(0,100000)] DWORD cPropNames,
   [in, size_is(cPropNames)] PropertyName_r** pNames,
   [out] PropertyTagArray_r** ppPropTags
 );
</pre></div>
</dd></dl><p><b>hRpc: </b>An <span><a href="1b8009c5-72bc-41da-bbab-612b31da4410#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a></span> context handle
as specified in section <span><a href="67195f6a-2002-4d81-b279-ba8b0aefb4af" data-linktype="relative-path">2.3.9</a></span>.</p><p><b>Reserved: </b>A <span><a href="../ms-dtyp/262627d8-3418-4627-9218-4ffe110850b2" data-linktype="relative-path">DWORD</a></span>
value reserved for future use. Ignored by the server.</p><p><b>dwFlags: </b>A DWORD value. All clients MUST set
this value to either 0 or the flag NspiVerifyNames.</p><p><b>cPropNames: </b>A DWORD value containing the
number property names supplied by the client. The value is limited to 100,000.</p><p><b>pNames: </b>A reference to a <span><a href="0060b749-9873-450e-9b4b-b288afc42dc5" data-linktype="relative-path">PropertyName_r</a></span>
value. Contains a list of property names supplied by the client.</p><p><b>ppPropTags: </b>A reference to a <span><a href="9dc42856-90da-4df9-85ca-f8307db84659" data-linktype="relative-path">PropertyTagArray_r</a></span>
value. On successful return to the client, contains a list of proptags.</p><p><b>Return Values: </b>The server returns a long value
specifying the return status of the method.</p><p>Exceptions Thrown</p><p>No exceptions are thrown beyond those thrown by the
underlying RPC protocol, as specified in <span><a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a></span>.</p><p>Server Processing Rules</p><p>Upon receiving this message, the server MUST process the
data from the message subject to the following constraints: </p><ol><li><p><span>    </span>If the server
returns any return value other than Success or ErrorsReturned, the server MUST
return a NULL for the output parameters <i>ppPropTags</i>.</p>
</li><li><p><span>    </span>The server MAY
make additional validations as described in section <span><a href="39bcbcd7-fa18-4eb2-a2ae-c598b6683185" data-linktype="relative-path">5</a></span>. If the server
chooses to limit the visibility of data based on these validations, the server
MUST proceed as if that data did not exist in the address book. See the product
behavior note cited in section <span><a href="36c0f768-1fdd-4709-9875-6c387b107560" data-linktype="relative-path">5.1</a></span> for more
information.</p>
</li><li><p><span>    </span>The server
constructs a list of proptags. This list MUST be in a one-to-one order preserving
correspondence with the list of names specified in the input parameter <i>pNames</i>.
The values in this list are constructed as follows:</p>
<ol><li><p><span>   
</span>If the <i>lpGuid</i> field of the PropertyName_r structure that the <i>pNames</i>
input parameter points to is NULL, the server MUST insert the proptag value
0x0000000A into the list.</p>
</li><li><p><span>   
</span>If the server is unable to locate a proptag corresponding to a property
name, the server MUST insert the proptag value 0x0000000A into the list.</p>
</li><li><p><span>   
</span>If the server is able to locate a proptag corresponding to a property
name, the server MUST insert the proptag thus mapped into the list. However,
the Property Type of the proptag inserted into the list is modified to be
UnspecifiedType, regardless of the original Property Type in the proptag thus
mapped.</p>
</li></ol></li><li><p><span>    </span>If the proptag
value 0x0000000A appears in the constructed list of proptags and the flag
NspiVerifyNames appears in the input parameter <i>dwFlags</i>, the server MUST
return the value AccessDenied.</p>
</li><li><p><span>    </span>If the proptag
value 0x0000000A appears in the constructed list of proptags and the flag
NspiVerifyNames does not appear in the input parameter <i>dwFlags</i>, the
server MUST return the value ErrorsReturned.</p>
</li><li><p><span>    </span>Subject to the
prior constraints, the server MUST return the constructed list of proptags in
the output parameter <i>ppPropTags</i>. </p>
</li><li><p><span>    </span>If no other
return values have been specified by these constraints, the server MUST return
the return value Success.</p>
</li></ol></div>