IOPLEX
Communications Software
Plexcel for PHP - Active Directory PHP Integration
plexcel_new
plexcel_status
plexcel_find_authorities_by_domain
plexcel_get_authority
plexcel_get_domain
plexcel_log
plexcel_preamble
plexcel_authenticate
plexcel_sso
plexcel_logon
plexcel_logoff
plexcel_accept_token
plexcel_is_member_of
plexcel_set_password
plexcel_change_password
plexcel_gen_service_keytab
plexcel_search_objects
plexcel_get_account
plexcel_add_object
plexcel_modify_object
plexcel_delete_object
plexcel_rename_object
plexcel_set_attrdefs
plexcel_get_attrdefs
plexcel_set_conv_attrdefs

plexcel_get_domain

Printer Friendly Format

Synopsis

array plexcel_get_domain(resource $px, string $dname)

Description

The plexcel_get_domain function retrieves information about the named domain including it's dnsRoot , nETBIOSName and objectSid . The $dname parameter may be NULL to indicate that the default domain of the supplied $px context should be returned.

This function is particularly useful for canonicalizing usernames before calling plexcel_logon (e.g. convert EXAMPLE\username to username@example.com as required by plexcel_logon ).

Note: Currently this function cannot be used with NetBIOS domain names unless the corresponding DNS name is resolved first. Plexcel currently does not support NetBIOS name lookups. See Issue 11 in the Plexcel Operator's Manual.

Returns

The plexcel_get_domain function returns an array of attributes or FALSE to indicate that an error has occurred in which case plexcel_status should be consulted.

Example

The following PHP script prints information about the specified domain.

<?php

$dname = 'example.com';

$px = plexcel_new(null, null);
if (!$px)
    die('<pre>' . plexcel_status(NULL) . '</pre>');

$domain = plexcel_get_domain($px, $dname);
if ($domain === FALSE)
    die('<pre>' . plexcel_status($px) . '</pre>');

echo '<pre>';
print_r($domain);
echo '</pre>';
Retrieving the NetBIOSName, dnsRoot and objectSid of a domain with plexcel_get_domain.
© 2008 IOPLEX Software | Contact Us | Policies